Opal

Cookies for the future

We now use the `$cookies` api as part of moving to angular v1.5.8.

The default expiry of cookies is now a year in the future.

The cookie name previously stored as `opal.lastPatientList` is now
`opal.previousPatientList`.

Patients as a service

Patient becomes a service in angular. This takes in a patient as loaded by the patient loader or another service. It casts the data to Episode or Item instances as appropriate.

PatientList.get_queryset arguments

PatientList.get_queryset() is now passed an extra keyword argument - `user`.
This is the current `User` object.

Overriding default Menu Items behaviour

The `get_menu_items` method of Opal Application objects is now passed an extra keyword argument - `user`.
This is the current `User` object.

The templatetag application_menuitems now uses this method to render navigation menus, allowing dynamic
customisation of menu contents based on user.

Removals

Opal 0.8.1 removes some minor features which, to our knowledge are not used by any applications in active development.

* ReopenEpisodeCtrl - applications may implement their own 're-open' episode flow, but Opal no longer handles this out of the box.
* Subrecord._bulk_serialise - this flag has been removed

Pending removals

We have re-named `opal.core.views._build_json_response` to `opal.core.views.json_response`. This will issue a
warning for the remainder of the 0.8.x branch, before being removed entirely in Opal 0.9.0.

Subrecord List API

We have added a list method to the default Opal JSON API for subrecords - you may now obtain a list of all instances
of a given subrecord from the API endpoint `/api/v0.1/$api_name/`.

Misc Changes

Updates the custom `UserAdmin` so that the email, first and last name fields from the Django `User` model
are in the add user form not just the edit user form.

The default test runner generated by plugin scaffolding now uses `opal.urls` as the default url conf in the test settings. This allows you to test urls generated by Opal - for instance default form or record templates, or simply raw templates from our generic template view.

* `Options` - both from the JSON API, and the Angular service.
* The legacy APIs `/api/v0.1/episode/admit` and `/api/v0.1/episode/refer`.
* The models `GP`, `CommunityNurse` and `LocatedModel`.
* `opal.models.Tagging.import_from_reversion`. This one-off classmethod on tagging was introduced to aid with the upgrade from Opal 4.x to 5.0 and has no further utility.
* The `static` argument from the forms `input` tag. Developers should move to the `static` tag.
* The _modal option to set on subrecords. This is because we now use large modals across the board.


Misc changes

The opal.core.api.EpisodeViewSet.create now expects tagging to be an object rather than a list, similar to how it details with demographics and location.

The API will no longer serialise the _ft or _fk_id fields of FreeTextOrForeignKey fields - these
are internal implementation details of the server that are not useful on the client side.

Adds a Unique Together constraint for (Tagging.user, Tagging.episode, Tagging.value)

Look up lists now load in from individual apps. The look for a file at {{ app }}/data/lookuplists.json

The default admin url is now `/admin/` - rather than `/admin/?` this results in more readable
admin urls and is closer to what most applications do with the Django admin.

The roles field `opal.models.UserProfile.roles` has been updated to be `blank=True`. This allows the editing
of users without specific roles assigned in the Django admin. Although this introduces no changes at the
database level, this does introduce a migration.

Updates to the Dependency Graph

Upgrades angular to v1.5.8 (from 1.3.11) you can see their change log [here](https://github.com/angular/angular.js/blob/master/CHANGELOG.md)

Updates angular-cookies and angular-mocks to v1.5.8 (both from 1.3.11)

The flow enter and exif functions now take an optional context argument. When called from PatientList or PatientDetail controllers this is the parent scope when the flow has been entered.

Note: The current Flow API is likely to undergo substantial revision in Opal 0.9 / 0.10 do contact us on the mailing list if you are relying heavily upon it or would like to let us know your needs.

Adds a past filter, future and past filters now take a
boolean argument as to whether you should include today

Fixes a bug whereby celery tasks are not autodiscovered - will have affected users of async extract functionality.

Fixes a bug with the copy to category API not setting category name.

Removes the hangover use of options in the list of teams per episode in the patient list