# Publisher

Publisher is the primary content design app for GovUK. It provides the user interface for
entering all the key editorial formats and an API so other apps (primarily frontend) can
access that data for display. It is intended to work in partnership with Panopticon which
manages metadata, slugs, titles, etc.

## Running in development

If you're just interested in running the Publisher locally, with a minimum of interaction
with other apps, here's how.

*These instructions are out of date. Updates coming soon*

### Create a user

    guides$ script/console
    >> User.create name: "Your name", email: "youremail@example.com", uid: Time.now.to_i, version: 1

### Run panopticon using rails s or similar

    panopticon$ rails s -p 3001

### Run the guides app setting env variable to point at your panopticon instance

    guides$ PANOPTICON_URI="http://localhost:3001" bundle exec rails server

## Local Transactions

There is no UI or automated process for importing the source data for local transactions.

The source data can be downloaded from [http://local.direct.gov.uk/Data/local_authority_service_details.CSV](DirectGov).

They can be imported using a rake task:

    bundle exec rake local_transactions:import SOURCE=/path/to/local_authority_service_details.CSV

# Publisher

Publisher is the primary content design app for GovUK. It provides the user interface for
entering all the key editorial formats and an API so other apps (primarily frontend) can
access that data for display. It is intended to work in partnership with Panopticon which
manages metadata, slugs, titles, etc.

## Running in development

If you're just interested in running the Publisher locally, with a minimum of interaction
with other apps, here's how.

*These instructions are out of date. Updates coming soon*

### Create a user

    guides$ script/console
    >> User.create name: "Your name", email: "youremail@example.com", uid: Time.now.to_i, version: 1

### Run panopticon using rails s or similar

    panopticon$ rails s -p 3001

### Run the guides app setting env variable to point at your panopticon instance

    guides$ PANOPTICON_URI="http://localhost:3001" bundle exec rails server

## Local Transactions

There is no UI or automated process for importing the source data for local transactions.

The source data can be downloaded from [http://local.direct.gov.uk/Data/local_authority_service_details.CSV](DirectGov).

They can be imported using a rake task:

    bundle exec rake local_transactions:import SOURCE=/path/to/local_authority_service_details.CSV

## ENVIRONMENT

Various flags and settings can control the runtime behaviour of publisher.
These are mainly useful when working in development.

NO_TRANSPORT - don't try to connect to the STOMP message broker. 

e.g.

$ NO_TRANSPORT=1 bundle exec rails s

Add comments about disabling connection to STOMP.
Add comments about disabling connection to STOMP.
