.
This is a plugin for superdesk.
It allows to ingest and manage events, to create planning within agenda, and to link coverages to them.
In order for Superdesk to expose the Planning module, you must configure it in both the client and server config files.
Add the dependency to your instance of superdesk.
In superdesk/client/package.json
add superdesk-planning
to the dependencies
(replacing #a79d428
with the specific commit you require):
"dependencies": {
....,
"superdesk-planning": "superdesk/superdesk-planning#a79d428"
}
Don't forget to add planning to your superdesk config in superdesk/client/superdesk.config.js
, and
to enable the planning feature:
apps: [
....,
'superdesk-planning'
],
features: {
....,
planning: true
},
workspace: {
....,
planning: true,
assignments: true
}
If you have importApps
in your superdesk config, you should also add planning to this list:
importApps: [
....,
'superdesk-planning'
]
This will import the superdesk-planning
node module and load the superdesk.planning
angular module in the main angular application.
Finally install planning for javascript:
npm install
Add the dependency to your instance of superdesk.
In superdesk/server/requirements.txt
add superdesk-planning
to the dependencies
(replacing @a5b14c23e
with the specific commit you require):
git+git://github.com/superdesk/superdesk-planning.git@a5b14c23e#egg=superdesk-planning
Last thing you need to configure is to add planning
to the list of installed apps.
In superdesk/server/settings.py
add the following:
INSTALLED_APPS.extend([
....,
'planning'
])
Finally install planning for Python:
pip install -r requirements.txt
After performing the above steps, you can enable editing of your local copy for use with development.
First you will need to clone the repo from GitHub.
In the root folder where your current superdesk folder is, run the following:
git clone git@github.com:superdesk/superdesk-planning.git
Running the following will link the superdesk-planning module in development mode:
cd superdesk/client
npm install
npm link ../../superdesk-planning
cd ../..
Run the following to install the python module in development mode:
cd superdesk/server
pip install -r requirements.txt
cd ../../superdesk-planning
pip install -e .
cd ..
Below sections include the config options that can be defined in settings.py.
- PLANNING_EXPIRY_MINUTES
- Defaults to 0 - disabled
- PLANNING_DELETE_SPIKED_MINUTES
- Defaults to 0 - disabled
- ONCLUSIVE_MAX_OFFSET:
- Defaults to 10000
- Sets a maximum for how many events can be retrieved from the API.
- MAX_RECURRENT_EVENTS:
- Defaults to 200
- Defines an upper limit to how many events can be created in a recurring series of Events.
- STREET_MAP_URL:
- Defaults to 'https://www.google.com.au/maps/?q='
- Defines the generated url used when clicking on a location of an Event.
- MAX_MULTI_DAY_EVENT_DURATION:
- Defaults to 7
- Defines the maximum number of days a single event can span.
- PLANNING_EVENT_TEMPLATES_ENABLED:
- Defaults to False
- Enables the ability to create templates from an existing Event, and use them for creating new Events.
- EVENT_EXPORT_BODY_TEMPLATE:
- default: https://github.com/superdesk/superdesk-planning/blob/develop/server/planning/planning_export_templates.py#L39
- Overrides the default event template used for event exports
- EVENT_RELATED_ITEM_SEARCH_PROVIDER_NAME:
- Default: None
- Required By: Event field
related_items
(otherwise this field will be automatically disabled) - Defines the name of the Search Provider to use for adding related items to an Event
- LONG_EVENT_DURATION_THRESHOLD:
- Defaults to -1 - disabled
- PLANNING_EXPORT_BODY_TEMPLATE:
- Default: https://github.com/superdesk/superdesk-planning/blob/develop/server/planning/planning_export_templates.py#L39
- Overrides the default event template used for planning exports
- PLANNING_DEFAULT_COVERAGE_STATUS_ON_INGEST:
- Default: 'ncostat:int' - Coverage Planned
- The default CV qcode for populating planning.coverage[x].news_coverage_status on ingest
- DEFAULT_CREATE_PLANNING_SERIES_WITH_EVENT_SERIES
- Default: False
- If true, will default to creating series of Planning items with a recurring series of Events,
- SYNC_EVENT_FIELDS_TO_PLANNING
- Default: ""
- Comma separated list of Planning & Coverage fields to keep in sync with the associated Event
- Supported Fields:
- slugline
- internal_note
- name
- place (list CVs)
- subject (list CVs, exclude items with scheme)
- custom_vocabularies (list CVs, inside subject with scheme)
- anpa_category (list CVs)
- ednote
- language (includes
languages
if multilingual is enabled) - definition_short (copies to Planning item's
Description Text
) - priority
- PLANNING_DUPLICATE_RETAIN_ASSIGNEE_DETAILS
- Default: False (the current behavior where assignee details are removed)
- If true, the
assigned_to
field (assignee details) is retained when duplicating planning items with coverages.
- SLACK_BOT_TOKEN
- Defaults to ''
- The Bot User OAuth Token for access to Slack
- PLANNING_AUTO_ASSIGN_TO_WORKFLOW
- Defaults to false
- Automatically assigned a coverage to workflow
- PLANNING_SEND_NOTIFICATION_FOR_SELF_ASSIGNMENT
- Defaults to false
- If true, sends a notification to a user on creating an assignment that is assigned to themselves
- PLANNING_JSON_ASSIGNED_INFO_EXTENDED
- Defaults to
false
- If
true
, it will add to planning JSON output additional info for coverages like assigned desk name/email and assigned user name/email.
- Defaults to
- PLANNING_CHECK_FOR_ASSIGNMENT_ON_PUBLISH
- Defaults to false
- If true, check for unfulfilled assignments when publishing a story
- PLANNING_LINK_UPDATES_TO_COVERAGES
- Defaults to false
- If true, links content update to the assignment of the parent item
- PLANNING_FULFIL_ON_PUBLISH_FOR_DESKS
- Defaults to ''
- Desk IDs to display fulfil challenge on publish (requires PLANNING_CHECK_FOR_ASSIGNMENT_ON_PUBLISH=true)
- PLANNING_CHECK_FOR_ASSIGNMENT_ON_SEND
- Defaults to false
- If true, check for unfulfilled assignments when sending a story from an authoring desk to production desk
- PLANNING_ALLOWED_COVERAGE_LINK_TYPES
- Defaults to []
- This is an allow list of content types (text, picture etc) that can be linked to a coverage
- If this option is not defined, or is an empty array, then all content types can be linked
- Otherwise only the content types in the list are allowed to be linked to a coverage
- This includes fulfilment of an Assignment
redux-logger
To enable, create a local storage entry called "devtools" with a value '["redux-logger"]'
. It can be done by running the following command in the console:
localStorage.setItem('devtools', '["redux-logger"]')
There are a couple of steps to take to enable slack for assignment notifications.
- Add
features.slackNotifications: 1
to your superdesk.config.js file - Configure a SLACK_BOT_TOKEN in your settings.py
- Add
slackclient==1.0.9
to your requirements.txt file, and install using pip - Configure slack channel/user names in the Superdesk UI
SLACK CHANNEL NAME
in theGeneral
tab for a deskSLACK USERNAME
in theOverview
of each user
The following are celery tasks configured to perform periodic tasks specific to Planning.
There is a Celery Task to expire items after a configured amount of time.
In your settings.py, configure CELERY_TASK_ROUTES, CELERY_BEAT_SCHEDULE and PLANNING_EXPIRY_MINUTES:
CELERY_TASK_ROUTES['planning.flag_expired'] = {
'queue': celery_queue('expiry'),
'routing_key': 'expiry.planning'
}
CELERY_BEAT_SCHEDULE['planning:expiry'] = {
'task': 'planning.flag_expired',
'schedule': crontab(minute='0')
}
PLANNING_EXPIRY_MINUTES = 4320 # default is 0
The above example config will run the Celery Task once every hour, flagging items as expired after 3 days from the scheduled date.
If PLANNING_EXPIRY_MINUTES = 0, then no item will be flagged as expired (effectively disabling this feature)
There is also a manage.py command so that you can manually run this task.
python manage.py planning:flag_expired
This is a Celery Task to delete spiked planning items, associated assignments and events after a configured amount of time. Settings are very similar to "planning:flag_expired" task
In your settings.py, configure this task as follows using the variable PLANNING_DELETE_SPIKED_MINUTES:
CELERY_TASK_ROUTES['planning.delete_spiked'] = {
'queue': celery_queue(''),
'routing_key': 'delete.planning'
}
CELERY_BEAT_SCHEDULE['planning:delete'] = {
'task': 'planning.delete_spiked',
'schedule': crontab(minute='0')
}
PLANNING_DELETE_SPIKED_MINUTES = 4320 # default is 0
The above example config will run the Celery Task once every hour, deleting spiked items after 3 days from the scheduled date.
If PLANNING_EXPIRY_MINUTES = 0, then no item will be deleted
There is also a manage.py command so that you can manually run this task.
python manage.py planning:delete_spiked
This is a Celery Task to delete Assignments that have been marked by the system to be removed. This can happen when the Coverage is cancelled but the Assignemnt or content item is currently locked. This task will later on attempt to remove the Assignment once it is unlocked by the user.
The following is the default config if one is not defined:
CELERY_TASK_ROUTES['planning.delete_assignments'] = {
'queue': celery_queue('expiry'),
'routing_key': 'expiry.delete_assignments'
}
CELERY_BEAT_SCHEDULE['lanning:delete_assignments'] = {
'task': 'planning.delete_assignments',
'schedule': crontab(seconds=60)
}
To run the same tests that is used in Travis, run the following:
cd superdesk-planning
make test
cd ..
Or you can run them individually as below.
Code Style
cd superdesk-planning
npm run hint
cd ..
Unit Tests
cd superdesk-planning
npm run unit_test
cd ..
Coverage Report
cd superdesk-planning
npm run coveralls
cd ..
Code Style
cd superdesk-planning/server
flake8
cd ../..
Unit Tests
cd superdesk-planning/server
nosetests -v
cd ../..
Behaviour Tests
cd superdesk-planning/server
behave
cd ../..