Creme-crm

UPGRADE NOTE :
- You should create a all new virtual environment based on Python 3.6+
(e.g. "mkvirtualenv -p /usr/bin/python3XX" if you use 'mkvirtualenv')
and populate it with "pip install -e .[mysql|pgsql]" of course.
- The layout of Creme projects has changed : Creme is a classical Python package
installed in your virtualenv & your own data are stored in another place.
Create a fresh project folder with the following command (you must be out of the Creme's tree):
> creme creme_start_project my_project
- Edit the file "my_project/settings.py" ;
copy (carefully) the values from your old files "local_settings.py/project_settings.py".
- Do not forget to set the values for LANGUAGE_CODE & TIME_ZONE (the default
values in Creme 2.2 are 'fr' & 'Europe/Paris' ; if you did not set them
in your instance of Creme 2.2, use these values explicitly with Creme 2.3).
- The hard-coded sub-folder 'upload/' has been moved to the default value of 'settings.MEDIA_ROOT' ;
so if you have set 'MEDIA_ROOT' in your personal settings, add a sub-folder "upload" at the end
(to avoid breaking the paths of all your uploaded Documents, generated PDFs etc...).
Example:
> MEDIA_ROOT = os.path.join('var', 'www', 'example.com', 'media')
becomes
> MEDIA_ROOT = os.path.join('var', 'www', 'example.com', 'media', 'upload')
- The value of 'settings.GENERATED_MEDIA_DIR' is not used anymore ; 'settings.STATIC_ROOT' is used instead.
So if you have set 'GENERATED_MEDIA_DIR' in your personal settings, rename it "STATIC_ROOT".
Example:
> GENERATED_MEDIA_DIR = os.path.join('var', 'www', 'example.com', 'static')
becomes
> STATIC_ROOT = os.path.join('var', 'www', 'example.com', 'static')
- If your old setting MEDIA_ROOT had the default value ("creme/media/"), copy the content of the
folder "creme/media/upload/" of your old installation to the destination indicated by your new
setting MEDIA_ROOT ("my_project/media/upload/" by default in the generated file "my_project/settings.py").
If your old setting MEDIA_ROOT referenced a folder out of the default, you can just
make a backup of these uploaded files (backups are a good thing).
- Execute the well known commands "migrate", "creme_populate" & "generatemedia", but in a new way:
> creme migrate --settings=my_project.settings
> creme creme_populate --settings=my_project.settings
> creme generatemedia --settings=my_project.settings
- The undocumented options "colorize" & "colors" of 'creme.utils.loggers.CremeFormatter' have been removed ;
fix your settings if you used it (probably not).
- If you used the locale overloading (generated by the command "i18n_overload.py")
- Copy the content of the old folder "creme/locale_overload/locale/" in a new
folder "my_project/locale_overload/" (beware there is no "locale/" sub-folder).
- In your project's settings, add the line:
> LOCALE_PATHS.insert(0, BASE_DIR / 'locale_overload')

Users side :
------------
The version of Django has been upgraded to "3.2".
The layout of Creme projects has changed : now Creme lives as a classical Python package
in your virtualenv, and your settings/media are well separated from Creme's code
(see the new command "creme_start_project").
Two full-python backends for the media-generator have been added ;
they are used in the default configuration (see the setting 'ROOT_MEDIA_FILTERS') in order to remove the dependency to Java by default.
- The package "csscompressor" is used to minify the CSS files.
- The package "rjsmin" is used to minify the JavaScript files.
The history has been improved :
- The messages in the history block are prettier.
- Old & new values are stored now for TextFields (e.g. description) ; they are shown in a popover dialog.
- Elements which are added & removed for ManyToManyFields are now stored.
- CustomFields are now historized too.
The global search can now search in CustomFields.
The job scheduler can now use a UNIX socket (when they are available) to
communicate with the views, instead of a Redis server.
Many blocks got descriptions, which are displayed as tool-tips.
The field "modified" of entities is updated when you use inner/bulk edition with a CustomField.
Apps :
* Creme_config :
- The main menu can now be customised ; containers can be created,
re-ordered, removed, & their entries can be chosen too.
All apps have been reworked to use the new system to provide a menu identical to the old one.
- You can add a configuration of a Custom-Form specific to a role.
- The fields can now be marked as required in fields' configuration (not ManyToManyFields for now).
- The instances of CremePropertyTypes can now be disabled (to not be proposed in forms).
- The configuration form for blocks on detailed views has been redesigned
(the pool of available blocks is now shared, blocks are draggable, descriptions are displayed).
- A portal which displays all the filters (used by list-views) has been added.
- A portal which displays all the views (of list-views) has been added.
* Persons :
- A many-to-many field "Spoken language(s)" has been added to Contacts ; it's hidden for old installations.
- The setting PERSONS_MENU_CUSTOMERS_ENABLED has been removed (you can add/remove the entry menu in 'creme_config').
* Billing :
- The field 'payment_type' ("Settlement terms") is now present in all 'billing' entity types (Quote, SalesOrder...).
Notice that if you upgrade your Creme installation, if you want to display this field in the detail-views, you
have to edit your block configuration (excepted for 'Invoice' of course).
* Reports :
- The CustomFields with type DATE can now be used as abscissa in ReportGraphs (only DATETIME was available).
* Emails :
- When you create an email from a detailed view, only one of the 2 bodies needs to be filled
(the other one is automatically filled from it).
* Assistants :
- In Alerts & ToDos bricks, the validated lines can be shown/hidden. The default behaviour is still the same.

Developers side :
-----------------
- The version of 'Django' is now "3.2".
You should probably read the following releases notes for Django versions :

- The work on class-based views continues ; lots ot new function-views have been converted, but the biggest
changes happened for list-views.
The compatibility with function-views is totally broken, but migrating the code of your own list-views should be easy in most cases.
This new class-based list-view is more stronger ; for example you can now easily customise the buttons & the actions.
- The way the registration in 'creme_config' is done has heavily changed.
Now a method in the files "apps.py" is used instead of the files "creme_config_register.py".
Lot of things can now be configured about a model :
- The forms for creation & edition can now be different ; the deletion form can be customised now.
- The creation, edition & deletion URLs can be customised.
- The creation, edition & deletion can be disabled.
- The Brick used to display its instances can be customised.

Other important changes:
- The code related to EntityFilters have been heavily reworked (but it won't be a problem if you did not modified it) :
- A lot of code from 'creme_core.models.EntityFilterCondition' has moved to a new package : 'creme_core.core.entity_filter'.
- The code of the forms has notably been split (fields/widgets/forms).
- A new registry has been created to register handlers (which contain the behaviour code which was in 'EntityFilterCondition') & operands (new name for 'EntityFilterVariable').
- The code of the search in list-views has been massively reworked.
The old code was monolithic ; the new one is more extensible & customisable : it is separated in form/fields/widgets (like regular forms, plus some specialization).
A tree-registry has been created in order to easily customise the search-fields used for each column of the list-views
(see 'AppConfig.register_search_fields()' & 'creme_core.gui.listview.search.search_field_registry').

Non breaking changes :
----------------------
Deprecations :
- In 'creme_core.models':
- The method 'CremePropertyType.get_compatible_ones()' is deprecated ; use 'CremePropertyType.objects.compatible()' instead.
- The method 'Relation.get_compatible_ones()' is deprecated ; use 'RelationType.objects.compatible()' instead.
- The method 'Relation.filter_in()' is deprecated.
- A custom object manager has been added to 'bricks.BrickDetailviewLocation' :
- The method 'config_exists()' is deprecated ; use '.objects.filter_for_model()' instead.
- The method 'create_if_needed()' is deprecated ; use '.objects.create_if_needed() instead.
- The method 'create_4_model_brick()' is deprecated ; use '.objects.create_for_model_brick()' instead.
- The method 'id_is_4_model()' is deprecated.
- A custom object manager has been added to 'bricks.BrickState' :
- The method 'get_for_brick_id()' is deprecated ; use '.objects.get_for_brick_id()' instead.
- The method 'get_for_brick_ids()' is deprecated ; use '.objects.get_for_brick_ids()' instead.
- The method 'bricks.RelationBrickItem.create()' is deprecated ; use '.objects.create_if_needed()' instead.
- In 'creme_core.forms' :
- The class 'base.CremeModelWithUserForm' is deprecated ; use 'CremeModelForm' instead.
BEWARE : if you have a "Meta.fields" in you form, you may have to add "user".
- The method 'relation._RelationsCreateForm._hash_relation()' is deprecated.
- In 'creme_core.views' :
- In 'relation', these function-views are deprecated : 'delete_all()' & 'json_entity_rtypes()'.
The constant 'JSON_PREDICATE_FIELDS' is deprecated too.
- The mixin class 'generic.wizard.PopupWizardMixin' is deprecated ; use a class inheriting the base class 'generic.wizard.AbstractWizardView' instead.
- The method 'creme_core.enumerators.EntityFilterEnumerator.efilter_as_dict()' is deprecated ; use 'instance_as_dict()' instead.
- The function 'creme_core.utils.queries.get_q_from_dict()' is deprecated ; use 'django.db.models.query.Q(my_dict)' instead.
- The templatetags "{% get_export_backends %}" & "{% get_import_backends %}" (from the lib "creme_core_tags") are deprecated.
- These template files in "creme_core/generics/blockform/" are deprecated :
- add_wizard.html (use "add-wizard.html" instead).
- add_wizard_popup.html (use "add-wizard-popup.html" instead).
- edit_wizard_popup.html (use "edit-wizard-popup.html" instead).
- wizard_popup.html (use "base-wizard.html" instead).
- In JavaScript :
- The function 'creme.utils.appendInUrl()' is deprecated; use the function 'creme.utils.goTo()' or the class 'creme.ajax.URL' instead.
- The method 'creme.lv_widget.selectedLines()' is now deprecated; Use "$(list).list_view('selectedRows')" instead.
- Apps :
* Creme_config :
- The use of a module "creme_config_register" in an app is deprecated ; add a method "register_creme_config()" in the AppConfig instead.
- The function-view 'views.creme_property_type.delete()' (URL named "creme_config__delete_ptype") is deprecated ;
use the class 'creme_core.views.creme_property.PropertyTypeDeletion' (URL named "creme_core__delete_ptype") instead.
* Persons :
- The method 'models.AbstractOrganisation.get_all_managed_by_creme()' is deprecated ; use '.objects.filter_managed_by_creme()' instead.
* Activities :
- The method 'models.AbstractActivity.is_auto_orga_subject_enabled()' is deprecated ; use the function 'utils.is_auto_orga_subject_enabled()' instead.
- The method 'models.AbstractActivity.get_title_for_calendar()' is deprecated ; use the attribute 'title' instead.
- Some class-methods of 'models.AbstractActivity' have ben moved to a new manager :
- The method 'get_future_linked()' is deprecated ; use '.objects.future_linked()' instead.
- The method 'get_future_linked_for_orga()' is deprecated ; use '.objects.future_linked_to_organisation()' instead.
- The method 'get_past_linked()' is deprecated ; use '.objects.past_linked()' instead.
- The method 'get_past_linked_for_orga()' is deprecated ; use '.objects.past_linked_to_organisation()' instead.
- Several static-methods of 'models.Calendar' are deprecated :
- get_user_calendars().
- get_user_default_calendar() (use '.objects.get_default_calendar()' instead).
- new_color() (use '.objects.new_color()' instead).
- _create_default_calendar()' (use '.objects.create_default_calendar()' instead).
* Commercial :
- The template filter "|has_quickform" (from the lib "commercial_tags") is deprecated ; use "|ctype_has_quickform" (lib "creme_ctype") instead.
* Billing :
- 'constants.DISPLAY_PAYMENT_INFO_ONLY_CREME_ORGA' is deprecated ; use 'billing.settings_keys.payment_info_key.id' instead.
- These templates are deprecated :
- billing/frags/button_convert2invoice.html
- billing/frags/button_convert2order.html
- The JavaScript function 'creme.billing.generateInvoiceNumber()' is deprecated; use the action named "billing-hatmenubar-invoice-number" instead.
* Opportunities :
- 'constants.SETTING_USE_CURRENT_QUOTE' is deprecated.
- These methods of 'models.AbstractOpportunity' are deprecated: 'get_contacts()', 'get_products()', 'get_responsibles()', 'get_services()'.
* Reports :
- The function 'views.graph.cast_order()' is deprecated ; use the class 'creme_core.utils.meta.Order' instead.
- The JavaScript function 'creme.reports.exportReport()' is deprecated.
* Mobile :
- The template filter "|employers" is deprecated ; use the method 'AbstractContact.get_employers()' (so "my_contact.get_employers" in the template) instead.
* Crudity :
- The filter "|truncate" (from the lib "crudity_tags") is deprecated ; use "|truncatewords" and "|truncatewords" instead.
* Events :
- The template file "creme/events/templates/events/lv_button_link_contacts.html" is deprecated.
A string permission has been added : 'creme_core.auth.SUPERUSER_PERM'.
In 'creme_core.models' :
- Two new values for the field attribute "on_delete" are available in 'creme_core.models.deletion' : 'CREME_REPLACE' & 'CREME_REPLACE_NULL'.
They act respectively like regular PROTECT & SET_NULL, but they indicate to 'creme_config' that a
replacement value can be proposed to the user when an instance is deleted.
- The model-fields 'fields.CTypeForeignKey' & 'fields.CTypeOneToOneField' accept now a model class directly.
- A new method 'get_4_keys()' ahs been added in the manager of 'SettingValue' to retrieve several values at once.
- The model 'BrickState' can now store extra data in a JSON field to manage specific states.
- It's now possible to check already retrieved entities with an EntityFilter (see the new method 'accept()').
In 'creme_core.views' :
- Generic/base deletion views have been added.
- The list-views (& so their popup version) have now a <no-selection> mode.
In 'creme_core.forms' :
- Two new form-fields have been added : 'fields.EnhancedMultipleChoiceField' & 'fields.EnhancedModelMultipleChoiceField'.
They are Multiple[model]ChoiceField which allow to force some values & add help text to each choice.
- The label of the creation button in selectors can now be customised.
It's now possible to clean a 'FileField' in inner-edition. 'FileFields' are always excluded from choice of field in the bulk-update form.
A shortcut function function has been added : 'creme_core.shortcuts.get_bulk_or_404()'.
A decorator for the per-request cache has been added: 'creme_core.global_info.cached_per_request'.
In 'creme_core.core' :
- A method 'paginator.FlowPaginator.get_page()' has been added.
- A new system for ordering query has been introduced : 'creme_core.core.sorter'.
- You can check if your DB server is case-sensitive with this new function : 'db.is_db_case_sensitive()'.
- The calls to 'enumerable._EnumerableRegistry.register_*()' can now be chained.
A new assertion has been added to help the unit testing of forms : 'assertFormInstanceErrors()'.
In JavaScript, a method 'creme.component.Action.stack()', that returns previous actions chained by 'after()', has been added.

Breaking changes :
------------------
Deprecated stuffs which have been removed :
- In 'creme_core.models' :
- The class 'entity.EntityAction' has been removed.
- In 'entity.CremeEntity', these methods have been removed : 'allowed_unicode()' & 'get_entity_m2m_summary()'.
- The function 'lock.mutex_autolock()' has been removed.
- In 'creme_core.core' :
- The class 'function_field.FunctionFieldsManager' has been removed.
- The method 'reminder.ReminderRegistry.itervalues()' has been removed.
- In 'creme_core.templatetags.creme_core_tags' :
- These filters have been removed: "|get_tag", "|xrange", "|allowed_unicode".
- These tags have been removed: "{% get_field_verbose_name %}", "{% get_viewable_fields %}".
- In 'creme_core.views' :
- The argument "q_filter" of the list-view do not manage the old "dictionary" format (use 'QSerializer' instead).
- In 'generic', these functions have been removed :
- add.add_entity(), add.add_to_entity(), add.add_model_with_popup().
- edit.edit_entity(), edit.edit_related_to_entity(), edit.edit_model_with_popup().
- popup.inner_popup(), portal.app_portal()
- 'listview._clean_value()'.
- The function 'enumerable.json_list_enumerable()' has been removed.
- The function 'quick_forms.add()' has been removed.
- In 'creme_core.utils' :
- The function 'chunktools.iter_splitlinechunks()' has been removed.
- The function 'db.reorder_instances()' has been removed.
- In the function 'queries.get_q_from_dict()', the "~" feature has been removed.
- In the class 'creme_core.backends._BackendRegistry' these methods have been removed : 'iterbackends()' & 'iterkeys()'.
- The signal 'creme_core.signals.form_post_save' has been removed.
- The method 'creme_core.gui.menu.CreationFormsItem.verbose_unicode()' has been removed.
- The method 'creme_core.forms.creme_property._AddPropertiesForm._create_properties()' has been removed.
- 'creme_core.constants.MODELBLOCK_ID' has been removed.
- These template files of "creme/creme_core/templates/creme_core/" have been removed :
- generics/inner_popup.html
- generics/portal.html
- generics/blockform/add_popup.html, generics/blockform/edit_popup.html, generics/blockform/link_popup.html.
- generics/blockformset/add_popup.html, generics/blockformset/base.html.
- generics/form/add_innerpopup.html, generics/form/edit_innerpopup.html.
- templatetags/quickforms_panel.html
- In JavaScript, the function 'creme.relations.addRelationTo()' has been removed.
- Apps :
* Persons :
- In 'forms.contact.RelatedContactForm' :
- The argument "linked_orga" is mandatory.
- The attribute "rtype" can not be set with the 'initial' data any more.
- The deprecated function-views have been removed in :
- views.address
- views.contact
- views.organisation
* Documents :
- The function-views have been removed.
* Activities :
- 'constants.DISPLAY_REVIEW_ACTIVITIES_BLOCKS' has been removed.
- These methods of 'models.AbstractActivity' have been removed :
- _get_linked_for_ctypes_aux(), get_future_linked_for_ctypes(), get_past_linked_for_ctypes()
- display_review()
- The deprecated function-views of 'views.activity' have been removed.
- In 'views.bricks' :
- The function-view 'delete_participant()' has been replaced by the class 'ParticipantRemoving'.
- The function-view 'unlink_activity()' has been replaced by the class 'ActivityUnlinking'.
- The JavaScript function 'creme.activities.exportAsICal()' have been removed.
- These templates in "creme/activities/templates/activities/" : "add_popup_activity_form.html", "view_activity_popup.html" & "frags/ical_list_view_button.html".
* Products :
- The deprecated function-views have been removed in :
- views.product
- views.service
* Billing :
- 'constants.CURRENCY' has been removed.
- The method 'registry.AlgoRegistry.itervalues()' has been removed.
- In 'models.AbstractTemplateBase', the method 'get_verbose_status()' & the property 'verbose_status' have been removed.
- The deprecated function-views have been removed in :
- views.credit_note
- views.invoice
- views.line
- views.quote
- views.sales_order
- views.templatebase
- The module 'views.workflow' has been removed.
- The JavaScript function 'creme.billing.exportAs()' has been removed.
* Opportunities :
- These classes in 'forms.opportunity' have been removed : 'OpportunityEditForm' & 'OpportunityCreateForm'.
- The method 'models.AbstractOpportunity.get_weighted_sales()' has been removed.
- The function-views have been removed in 'views.opportunity'.
* Commercial :
- The class 'forms.salesman.SalesManCreateForm' has been removed.
- The method 'models.CommercialApproach.get_approaches_for_ctypes()' has been removed.
- The deprecated function-views have been removed in :
- views.act
- views.salesman
- views.strategy
* Reports :
- In 'bricks.ReportGraphBrick', the variable "instance_block_id" is not injected in the context any more.
- The method 'report_aggregation_registry.FieldAggregationRegistry.itervalues()' has been removed.
- In 'models.graph.AbstractReportGraph' :
- these methods have ben removed: 'get_fetcher_from_instance_block()' & 'create_instance_block_config_item()'.
- The nested class 'InstanceBlockConfigItemError' has been removed.
- The deprecated function-views have been removed in :
- views.graph
- views.report
- The template file "creme/reports/templates/reports/frags/report_export_filter.html" has been removed.
* Assistants :
- The methods 'models.Action.get_actions_*()' have been removed.
- The methods 'models.Alert.get_alerts*()' have been removed.
- The methods 'models.Memo.get_memos*()' have been removed.
- The methods 'models.ToDo.get_todos*()' have been removed.
- The methods 'models.UserMessage.get_messages*()' have been removed.
* Emails :
- These classes in 'forms.mail' have been removed : 'TemplateSelectionForm' & 'EntityEmailFromTemplateForm'.
- The deprecated function-views have been removed in :
- views.campaign
- views.mail
- views.mailing_list
- views.sending
- views.template
- These templates in "creme/emails/templates/emails": "popup_sending.html", "view_email.html" & "view_entity_mail_popup.html".
- Tickets :
- The method 'models.AbstractTicket.get_resolving_duration()' has been removed.
- The function-views have been removed.
* Geolocation :
- The function 'utils.get_setting()' has been removed.
* Mobile :
- The deprecated function-views have been removed.
* Events :
- In 'views.event', the deprecated function-views have been removed.
* Graphs :
- In 'views.graph', the deprecated function-views have been removed.
* Projects :
- The deprecated function-views have been removed in :
- views.project
- views.task
* Polls :
- The deprecated function-views have been removed in :
- views.campaign
- views.poll_form
- views.poll_reply
* Recurrents :
- The function-views have been removed.
* CTI :
- The deprecated function-views have been removed ('abstract_add_*()' & 'add_*()').
* SMS :
- The function-views have been removed in :
- views.campaign
- views.messaging_list
- views.template
- The template file "creme/sms/templates/sms/popup_sending.html" has been removed.
About the upgrade to 'Django 2.0' :
- In form fields constructors, positional arguments must be replaced by keyword arguments.
- The imports <from django.conf.urls import url> should be replaced by <from django.urls import re_path>.
- In custom model fields, the argument "context" of method 'from_db_value()' should be removed.
- The internal cache management of 'ForeignKey' has slightly changed ; a internal '_state' attribute has been added in instances.
About the upgrade to 'Django 2.1' :
- The function 'django.template.defaultfilters.linebreaks()' generates "<br>" instead of "<br />".
About the upgrade to 'Django 2.2'.
- The function 'django.utils.http.urlencode()' now raises TypeError if None is passed as a value to encode.
- When performing queries like '.annotate().values()' (GROUP BY), an explicit order_by() should be made.
If you have coded your own entity class with a "description" field, you should migrate it to store your data in CremeEntity table.
If you have written a creation form/view which creates some (not internal) Relations,
it can now fail because of duplicated Relationships if you don't use the safe creation methods ('Relation.objects.safe_create()' & 'Relation.objects.safe_multi_save()').
- In forms, you should use the new method 'CremeEntityForm._get_relations_to_create()'.
- In views, use the argument "forced_relations" in 'get_form_kwargs()' instead of creating the Relation in the view.
The "development" mode of the media generator has been removed. It was broken & so nobody used it.
- These settings have been removed from 'settings.py' : "MEDIA_DEV_MODE" & "DEV_MEDIA_URL".
- The middleware "mediagenerator.middleware.MediaMiddleware" is not available anymore.
The method 'creme_core.auth.entity_credentials.EntityCredentials.filter_entities()' can now raise an exception ('EntityCredentials.FilteringError')
if the credentials use an EntityFilter on specific fields (so a 'QuerySet' on 'CremeEntity' is not possible).
In 'creme_core.models' :
- The method 'base.CremeModel._delete_m2m()' has been removed.
- The argument of 'relation.RelationType.is_compatible()' is positional only now.
- In 'entity_filter.EntityFilterCondition' :
- The constructor expects the new argument "model" to be given if you don't pass the argument "filter".
- The nested class 'ValueError' has been removed.
- These attributes have been removed :
- EFC_SUBFILTER, EFC_FIELD & other type IDs (see new module 'creme_core.core.entity_filter.condition_handler').
- EQUALS, IEQUALS & other operator IDs (see new module 'creme_core.core.entity_filter.operators').
- _subfilter_cache
- _GET_Q_FUNCS, _GET_DISTINCT_FUNCS
- _OPERATOR_MAP, _FIELDTYPES_ALL, _FIELDTYPES_ORDERABLE, _FIELDTYPES_RELATED, _FIELDTYPES_NULLABLE.
- These methods have been removed :
- build_4_customfield() (use 'creme_core.core.entity_filter.condition_handler.CustomFieldConditionHandler.build_condition()' instead).
- build_4_datecustomfield() (use 'creme_core.core.entity_filter.condition_handler.DateCustomFieldConditionHandler.build_condition()' instead).
- build_4_field() (use 'creme_core.core.entity_filter.condition_handler.RegularFieldConditionHandler.build_condition()' instead).
- build_4_date() (use 'creme_core.core.entity_filter.condition_handler.DateRegularFieldConditionHandler.build_condition()' instead).
- build_4_property() (use 'creme_core.core.entity_filter.condition_handler.PropertyConditionHandler.build_condition()' instead).
- build_4_relation() (use 'creme_core.core.entity_filter.condition_handler.RelationConditionHandler.build_condition()' instead).
- build_4_relation_subfilter() (use 'creme_core.core.entity_filter.condition_handler.RelationSubFilterConditionHandler.build_condition()' instead).
- build_4_subfilter() (use 'creme_core.core.entity_filter.condition_handler.SubFilterConditionHandler.build_condition()' instead).
- _get_q_*(), _load_daterange(), _build_daterange_dict().
- In 'entity_filter.EntityFilter', these methods have been removed : 'resolve_variable()' & 'get_variable()'.
- In 'entity_filter', these classes have been removed :
- EntityFilterVariable & _CurrentUserVariable (see new module 'creme_core.core.entity_filter.operands').
- _ConditionOperator, _IsEmptyOperator, _RangeOperator (see new module 'creme_core.core.entity_filter.operators').
In 'creme_core.core' :
- The class 'entity_cell.EntityCell' has been reworked (some parts are now useless) :
- These attributes of have been removed : 'editable', 'filter_string', 'has_a_filter', 'sortable'.
- The class attribute 'EntityCellCustomField._CF_PATTERNS' has been removed.
- In 'function_field.FunctionField' :
- The method 'populate_entities()' is now a regular method (it was a 'classmethod').
- The class attributes "has_filter" & "choices" have been removed.
- The class method "filter_in_result()" has been removed ; use the new class attribute "search_field_class" instead.
In 'creme_core.views' :
- In 'generic.listview' :
- The constants 'MODE_SINGLE_SELECTION' & 'MODE_MULTIPLE_SELECTION' has been removed (see the enum 'SelectionMode').
- The function-views 'list_view()' has been replaced by the class 'EntitiesList'.
- The function-views 'list_view_popup()' has been replaced by the class 'BaseEntitiesListPopup'.
- These functions have been removed : 'list_view_content()', '_build_entities_page()', '_build_entity_queryset()', '_build_extrafilter()', '_select_entityfilter()', '_build_rowscount()'.
- The GET/POST argument "sort_field" has been renamed "sort_key".
- The GET/POST argument "sort_order" value should be "ASC"/"DESC" (instead of ""/"-") ("" -- for ASC -- still works by the way).
- The GET/POST argument "o2m" has been renamed "mode" & accept only "single", "multiple" & "none" values.
- These views of 'entity' are now class-based :
- 'clone()' has been replaced by the class 'Clone'.
- 'delete_related_to_entity()' has been replaced by the class 'RelatedToEntityDeletion'.
- 'list_view_popup()' has been replaced by the class 'EntitiesListPopup'.
- 'search_and_view()' has been replaced by the class 'SearchAndView'.
- 'select_entity_for_merge()' has been replaced by the class 'EntitiesToMergeSelection'.
- 'merge()' has been replaced by the class 'Merge'.
- These views of 'creme_property' are now class-based :
- 'delete_from_type()' has been replaced by the class 'PropertyFromFieldsDeletion'.
- 'delete_type()' has been replaced by the class 'PropertyTypeDeletion'.
- The function-view 'bricks.set_state()' has been replaced by the class 'BrickStateSetting'.
- These views of 'entity_filter' are now class-based :
- 'delete()' has been replaced by the class 'EntityFilterDeletion'.
- 'get_for_ctype()' has been replaced by the class 'EntityFilterChoices'.
- These views of 'header_filter' are now class-based :
- 'delete()' has been replaced by the class 'HeaderFilterDeletion'.
- 'get_for_ctype()' has been replaced by the class 'HeaderFilterChoices'.
- The function-view 'job.delete()' has been replaced by the class 'JobDeletion'.
- These views of 'relation' are now class-based :
- 'select_relations_objects()' has been replaced by the class 'RelationsObjectsSelectionPopup'.
- 'delete()' has been replaced by the class 'RelationDeletion'.
- 'delete_similar()' has been replaced by the class 'RelationFromFieldsDeletion'.
- The function-view 'search.light_search()' has been replaced by the class 'LightSearch'.
- In 'enumerable' :
- The function-view 'json_list_enumerable_custom()' has been replaced by the class 'CustomFieldEnumsView'.
- The function-view 'json_list_userfilter()' has been replaced by the class 'creme_core.views.entity_filter.UserChoicesView'.
- The method 'ChoicesView.get_model()' has been removed.
- The URL named "creme_core__efilter_user_choices" has changed (no change if you used 'reverse()' of course).
- The view which exports the data from list-views as CSV/XLS has changed :
- The function-view 'list_view_export.dl_listview()' has been replaced by the class-based view 'mass_export.MassExport'.
- The URL "creme_core/list_view/download" (named "creme_core__dl_listview") has been replaced by the URL "creme_core/mass_export" (named "creme_core__mass_export").
Only GET arguments are used for filter, search ...etc (i.e. stored state is not used any more) ; the GET argument "list_url" is not used anymore.
In 'creme_core.gui' :
- The function 'field_printers.print_integer()' returns always a string now (it could return an integer).
- The method 'gui.bricks._BrickRegistry.register_4_model()' does not accept brick class with <id_ != constants.MODELBRICK_ID> (tips: inherit the class 'EntityBrick').
- In the class 'listview.ListViewState' :
- The attribute "sort_field" has been renamed "sort_cell_key".
- These methods have been removed: 'set_sort()', '_get_default_sort()', '_get_sortfield()', '_get_regular_sortfield()'.
- The internal class '_OrderedField' has been removed.
In 'creme_core.forms' :
- The class 'base.CremeEntityForm' injected the "help_text" in widgets ; it's an old un-documented behaviour which has been removed (because it seems useless now).
- In 'entity_filter', the forms now use a registry to know available handlers & operators.
- The fields '*_conditions' have been removed & replaced by fields added in the constructor (with new names).
- The constructor has a new mandatory argument: "efilter_registry".
- The fields & widgets have now an attribute "efilter_registry" which should be filled to get a satisfactory behaviour (e.g. classical operators are proposed).
- In 'header_filter' :
- The class 'FieldConditionWidget' has been renamed 'FieldConditionSelector'.
- The class 'CustomFieldConditionWidget' has been renamed 'CustomFieldsConditionsWidget'.
In 'creme_core.utils.date_period.SimpleValueDatePeriod' (& child classes), the method '_ungettext()' has benn renamed '_ngettext()'.
In 'creme_core.templatetags' :
- The template-filter "|isiterable" (from "creme_core_tags") has been renamed "|is_iterable".
- In the library "creme_listview" :
- The tag "{% get_listview_entity_filters %}" has been replaced by "{% listview_entity_filters %}" (the related template file has changed too).
- The tag "{% get_listview_headerfilters %}" has been replaced by "{% listview_header_filters %}" (the related template file has changed too).
- The tag "{% get_listview_columns_header %}" has been removed (and the related template file too).
- These template-tags take only keyword-arguments now :
- From the lib "creme_history" : "{% history_summary %}".
- From the lib "creme_listview" :
- {% listview_entity_actions %}
- {% listview_header_actions %}
- {% listview_header_colspan %}
- {% listview_td_action_for_cell %}
From the lib "creme_query" : "{% query_entities_count %}".
From the lib "creme_search" : "{% search_form %}".
In 'creme_core.templates' :
- These template files have been removed :
- creme_core/generics/list_entities.html
- creme_core/frags/list_view.html
- creme_core/frags/list_view_content.html (see "creme_core/listview/content.html")
- "creme_core/forms/widgets/efilter-cfield-conditions.html" has been replaced by "creme_core/forms/widgets/efilter-conditions-list.html".
- In the template "creme_core/generics/blockform/base.html", the "persist" inputs have been removed.
- The structure of several pages has changed :
- In "creme_core/base.html", the node '<div id="sub_content">' has been removed.
- In "creme_core/detailview.html", the node '<div class="detailview">' has been removed.
- In "creme_core/my_page.html", the node '<div class="my_page">' has been removed.
- In "creme_config/portal.html", the node '<div class="portal ...">' has been removed.
In JavaScript :
- The signature of 'creme.utils.goTo()' has changed ; the argument are now (url, data, target) instead of (url, target).
- The class 'creme.ajax.Query' now sends an "error" event instead of a "cancel" one when an empty URL is given.
- The actions of 'creme.widget.ActionList' have been renamed :
- 'creme.widget.ActionButton' became 'creme.widget.SelectorAction'.
- 'creme.widget.ResetActionButton' became 'creme.widget.ResetSelectorAction'.
- 'creme.widget.CreateActionButton' became 'creme.widget.CreateSelectorAction'.
- The constructor of 'creme.search.SearchBox' has been completely reworked ;
'creme.search.SearchBox(<element query string>, <search url>, <advanced search url>)' is replaced by 'creme.search.SearchBox({searchUrl: <search url>, advancedSearchUrl: <advanced search url>).bind(<element>)'
- The main menu controller has been reworked ; theses functions has been removed 'creme.menu.bindEvents', 'creme.menu.openQuickForm' & 'creme.menu.openCreateAnyDialog'.
- There are several changes in 'creme.component.Action' :
- In the method 'Action.after()', the arguments "done" of an action are given to the following one only if the option "passArgs" is <true>.
- The "source" action is no longer given as first 'Action.start()' argument to the following action.
- 'creme.entity_cell.EntityCellsWidget(<element_id>, <samples JSON>)' is replaced by 'creme.entity_cell.EntityCellsWidget({samples: <samples dict>}).bind(<element>)'
- In 'creme.jobs', the functions 'decorateJobStatus()' & 'checkJobManager()' have been removed ; use components '*JobsMonitor' instead.
- In 'list_view.core' :
- "list_view('options', <...>)" no longer exists and is replaced by "list_view('prop', <...>)".
- These methods have been removed :
- The method 'countEntities()' (renamed to 'selectedRowsCount()').
- 'getSelectedEntities()' & 'getSelectedEntitiesAsArray()' (use 'selectedRows()' instead).
- 'getKdSubmit()' & 'setKdSubmit()'
- 'setSubmit' & 'getSubmit' (see new method 'submitState()').
- 'serializeMe()' (renamed to 'state()').
- 'setReloadUrl()' & 'getReloadUrl()' (use "list_view('prop', 'reloadUrl', [<url>])" ).
- 'isLoading()' (use "list_view('prop', 'isLoading')" ).
- 'getActionBuilders()' (use "list_view('prop', 'actionBuilders', [<builders>])" ).
- These options have been removed :
- "o2m" (renamed to "multiple").
- "reload_url" (renamed to "reloadUrl").
- "selected_rows", "selectable_class", "selected_class", "checkbox_selector", "all_boxes_selector" & "entity_separator".
- "kd_submitHandler".
- "beforeSubmit", "afterSubmit" & "submitHandler".
- "user_page" & "id_container".
- In 'creme.lv_widget' :
- 'creme.lv_widget.initialize()' has moved to 'creme.lv_widget.ListViewLauncher._initController'.
- 'creme.lv_widget.listViewAction' has been replaced by 'creme.lv_widget.ListViewDialogAction'.
- Theses function have been removed : 'deleteFilter()', 'findList()' & 'handleSort()'.
- In 'creme.utils', these old inner-popup functions have been removed :
- innerPopupUUID()
- showInnerPopup()
- reloadDialog()
- innerPopupFormAction()
- closeDialog()
- handleDialogSubmit()
The class 'creme_core.tests.views.base.CSVImportBaseTestCaseMixin' has been renamed 'MassImportBaseTestCaseMixin'.
Apps :
* Creme_config :
- in 'urls' :
- The URL "creme_config__edit_home_bricks" takes now an argument.
- The URL "creme_config__delete_home_brick" has a different behaviour ; the argument "id" has been replaced by the argument "role".
- The URL "creme_config__delete_instance" has changed ; it takes an argument "object_id", & returns a form.
- In 'creme_config.views' :
- Almost all function-views have been replaced by class-based views.
- All the wizard-views now inherit 'creme_core.views.generic.wizard.CremeWizardView' ;
so the attribute "wizard_title" became "title", & "permission" became "permissions".
- The nested class 'views.bricks.RelationCTypeBrickWizard._FieldsStep' has been removed.
- The nested class 'views.fields_config.FieldsConfigWizard._ConfigStep' has been removed.
- In 'views.user_role' :
- The class 'CredentialsAdding' has been replaced by 'CredentialsAddingWizard'.
- The class 'CredentialsEdition' has been replaced by 'CredentialsEditionWizard'.
- The nested classes 'RoleCreationWizard._CredentialsStep' & 'RoleEditionWizard._ExportableCTypesStep' have been removed.
- In 'forms.user_role' :
- The function 'forms.user_role.EmptyMultipleChoiceField()' has been removed.
- Theses classes have been removed : 'CredentialsGeneralStep', 'UserRoleCredentialsStep' & 'AddCredentialsForm'.
- The method '_UserRoleWizardFormStep.partial_save()' has been removed.
- The class 'forms.bricks.BrickHomeLocationsForm' has been removed.
- In 'bricks' :
- Many changes in the class 'BrickHomeLocationsBrick' & its template.
- In 'GenericModelBrick', the variable "model_name" is not injected in the context anymore.
- The template-filter "|is_custom" has been renamed "|config_is_custom".
* Persons :
- The method 'AbstractContact.get_employers()' now returns Organisations managed by the Contact too, and excludes deleted Organisations.
- The templatetag "{% persons_contact_first_employer %}" now excludes deleted Organisations.
- In the form 'forms.contact.RelatedContactForm', the fields "orga_overview" & "relation" have been removed.
* Documents :
- The template "documents/frags/previous.html" has been replaced by "documents/lv-button-previous.html".
* Activities :
- The function-view 'views.activity.get_types()' has been replaced by the class 'TypesChoices'.
- The function-view 'views.calendar.delete_user_calendar()' has been replaced by the class 'CalendarDeletion'.
- These function-views in 'views.calendar' have been removed :
- update_activity_date() (use the class 'ActivityDatesSetting' instead).
- user_calendar() (use the class 'CalendarView' instead -- beware, the template context has changed).
- get_users_activities() (use the class 'ActivitiesData' instead -- beware, it's now a GET view & the JSON has slightly changed).
- 'constants.MAX_ELEMENT_SEARCH' has been removed ; use these attributes of 'CalendarView' instead : 'calendars_search_threshold' & 'floating_activities_search_threshold'.
* Products :
- The function-view 'views.product.remove_image()' has been replaced by the class 'ImageRemoving'.
* Billing :
- In the class 'function_fields._BaseTotalFunctionField' (& child classes), the class-attribute "cache_attr" has been removed.
- The view named "billing__delete_related_cnote" now accepts only POST requests.
- The function-view 'views.convert.convert()' has been removed ; use the class 'Conversion' instead.
- The function-view 'views.credit_note.delete_related_credit_note()' has been replaced by the class 'CreditNoteRemoving'.
- The function-view 'views.payment_information.set_default()' has been replaced by the class 'PaymentInformationAsDefault'.
- The conversion matrix has changed. These cases have been removed (they were not used in the UI):
- CreditNote => Invoice
- Invoice => SalesOrder
* Opportunities :
- The function-view 'views.billing.current_quote()' has been replaced by the class 'CurrentQuoteSetting'.
- The function-view 'views.billing.generate_new_doc()' has been replaced by the class 'BillingDocGeneration'.
- The dict 'views.billing._GEN_BEHAVIOURS' has been removed.
* Commercial :
- The function-view 'views.strategy.delete_evalorga()' has been replaced by the class 'OrganisationRemoving'.
* Reports :
- The registrations are made in "apps.py" now & the method 'FieldAggregationRegistry.register()' has only one argument now.
- The function-view 'views.graph.fetch_graph()' has been replaced by the class 'GraphFetching'. Beware this new view does not return the "graph_id" any more (because it was useless).
- The function-view 'views.graph.fetch_graph_from_instancebrick()' has been replaced by the class 'GraphFetchingForInstance'.
- The class 'ReportGraphForm' does not inherit 'CremeEntityForm' any more ('CremeModelForm' instead).
* Assistants :
- The function-view 'views.user_message.delete()' has been replaced by the class 'UserMessageDeletion'.
* Emails :
- The function-view 'views.campaign.delete_ml()' has been replaced by the class 'MailingListRemoving'.
- In 'views.mail':
- The class 'EntityEmailWizard' now inherits 'AbstractWizardView' (so "permission" became "permissions" etc...).
- The nested class 'EntityEmailWizard._EmailCreationFormStep' has been removed.
- In 'views.mailing_list':
- The function '_delete_aux()' has been removed.
- These function-views has been removed :
- delete_contact() (replaced by the class 'ContactRemoving').
- delete_organisation() (replaced by the class 'OrganisationRemoving').
- delete_child() (replaced by the class 'ChildRemoving').
- The function-view 'views.signature.delete()' has been replaced by the class 'SignatureDeletion'.
- The function-view 'views.template.delete_attachment()' has been replaced by the class 'AttachmentRemoving'.
- The form class 'forms.mail.EntityEmailForm' inherits 'CremeModelForm' and not 'CremeEntityForm' anymore.
- In 'bricks.EmailRecipientsBrick' & 'bricks.SendingsBrick', "ct_id" is not injected in the context anymore.
- In 'buttons.EntityEmailLinkButton', "entity_email_ct_id" is not injected in the context anymore.
* Events :
- The constants 'INV_STATUS_MAP' & 'PRES_STATUS_MAP' have moved from 'views.event' to 'constants'.
* Graphs :
- The function-view 'views.graph.delete_relation_type()' has been replaced by the class 'RelationTypeRemoving'.
- The function-view 'views.root_node.delete()' has been replaced by the class 'RootNodeDeletion'.
* Polls :
- The function-view 'views.poll_form.get_choices()' has been replaced by the class 'LineChoices'.
- In 'forms.poll_reply.PollRepliesCreateForm' :
- The attribute "instance" has been removed.
- The special behaviour (removing related field & keeping the value fixed) of initial data for "pform", "campaign" & "persons" has been removed.
* Projects :
- The function-view 'views.resource.delete()' has been replaced by the class 'ResourceDeletion'.
- The function-view 'views.task.delete_parent()' has been replaced by the class 'ParentRemoving'.
- The function-view 'views.task.delete_activity()' has been replaced by the class 'ActivityDeletion'.
- The class 'forms.resource.ResourceCreateForm' does not inherit 'CremeEntityForm' any more.
* SMS :
- The function-view 'views.campaign.delete_messaging_list()' has been replaced by the class 'MessagingListRemoving'.
- The function-views 'views.messaging_list._delete_aux()/delete_contact()' have been replaced by the class 'ContactRemoving'.
- The templatetags "phonenumber" & "formatphone" have been renamed "sms_phonenumber" & "sms_formatphone".

Internal breaking changes :
---------------------------
(they should not cause problem if you have not deeply modified the source code of Creme)

'creme.urls.handler403' is now a function (it was a string).
In 'creme_core.models' :
- The method 'auth.SetCredentials.set_value()' uses now keyword-arguments only.
- In 'entity_filter' :
- There were some changes in the JSON of 'EntityFilterCondition' for 'CustomFields':
- The key "value" became "values".
- The values are now always a list (old data generated by an old form which are not using list have been migrated).
- These functions have been removed : '_delete_relationtype_efc()' & '_delete_customfield_efc()'.
The return value of 'creme_core.forms.fields.MultiRelationEntityField._build_rtype_cache()' has changed : the IDs of CremePropertyTypes are now stored in a list.
In 'creme_core.views.entity_filter' these mixins have been removed : 'FilterCreationMixin' & 'FilterEditionMixin'.
About the module 'creme_core.gui.listview' :
- It has been split in several .py files.
- These methods of 'ListViewState' have been removed: 'clear_research()', 'handle_research()', 'get_q_with_research()', '_build_condition()', '_build_date_range_dict()', '_date_or_None()'.
- The function 'simple_value()' has been removed.
The list-views no longer support "whoami" in both POST & GET requests.
In the templatetag library "creme_listview", these functions have benn removed: '_build_bool_search_widget()', '_build_date_search_widget()' & '_build_select_search_widget()'.
In JavaScript, the class 'creme.action.ActionBuilderRegistry' has been renamed/moved as 'creme.component.FactoryRegistry'.
Apps :
* Creme_config :
- There are many changes in 'registry'.
- These functions of 'views.user_settings' have been removed : '_set_usersetting()', 'set_theme()' & 'set_timezone()'.
* Activities :
- These method of 'models.AbstractActivity' are deprecated : '_get_linked_aux()' & '_get_linked_for_orga()'.
- These functions of 'views.calendar' have been removed : '_activity_2_dict()', '_filter_authorized_calendars()', '_get_datetime()' & '_get_one_activity_per_calendar()'.
- There are some changes in the template "activities/templates/activities/calendar.html" (see the new 'CalendarView' context).
- In JavaScript :
- Some changes which follow the changes of "calendar.html".
- There are some changes to use the view 'ActivitiesData': GET instead of POST, "color" key instead of "calendar_color".
- The function 'creme.activities.calendar.loadCalendarEventListeners()' takes an additional argument ("select_calendars_url").
* Mobile :
- The instances of 'MobileFavorite' are now unique for the couple ('entity', 'user').
* Crudity :
- In JavaScript, the class 'creme.crudity.CrudityHatController' replaces the function 'refreshWaitingActions()'.

UPGRADE NOTE :
- You should create a all new virtual environment based on Python 3.5+
(e.g. "mkvirtualenv -p /usr/bin/python3XX" if you use 'mkvirtualenv')
and populate it with "pip install -r creme/requirements.txt" of course.
- Execute the well known commands "migrate", "generatemedia" & "creme_populate".

Users side :
------------
A list-view action has been added : "clone" (for entities which support cloning of course).
The style of the popup-dialogs has been improved (title & icon always in the header).
The image viewer has been improved.
Apps:
* Persons :
* A statistic has been added : count of prospects & suspects.
* Activities :
- A statistic has been added : average number of meetings/phone calls per month (since one year).
- The list-view button "Download as iCalendar" has been converted to a bulk action.
* Reports :
- You can now see the instances bricks related to a graph directly from the "Graphs" brick.
- A list-view action for Reports has been added : "export".
- The quick-search (in list-view) on the field <Report.filter> groups the filters by apps.
* Emails :
- Sendings have now a true detail-view :
- The template used for a sending can now be viewed.
- A link to the entity related to a mail has been added in the emails's brick.
- A list-view action & a bulk-action have been added for Emails : "resend".
* Tickets :
- A statistic has been added : count of not closed tickets.
* Opportunities :
- The statistics of 'opportunities' have been improved.
* Documents :
- A list-view action has been added for Documents: "download".
* Billing :
- A list-view action has been added for Invoice & Quote : "download".
* Events :
- The view to link contact has been improved.
The user is redirected to the event's contacts list-view (& not the event detail-view any more) ; there are better title, submission label & icon too.
* Assistants :
- The Alerts/ToDos/... which are related to a deleted entity are not displayed on their home bricks any more.

Developers side :
-----------------
In this version, there are 2 main changes for developers :
- We now use <Python 3.5> instead of <Python 2.7>.
You can find the complete release notes of Python versions here :
https://docs.python.org/3/whatsnew/3.0.html
https://docs.python.org/3/whatsnew/3.1.html
https://docs.python.org/3/whatsnew/3.2.html
https://docs.python.org/3/whatsnew/3.3.html
https://docs.python.org/3/whatsnew/3.4.html
https://docs.python.org/3/whatsnew/3.5.html
The code has not been fixed to "just work" ; lots of changes have been done to be more consistent.
For example, several methods called 'itervalues()' have been deprecated because their name was referencing the old dictionary API.
Lots of <%s-format> string have been converted to <{}-format">.
- Views are going to class :
- Almost all generic views of 'creme_core' are now class-based (but not list-views yet) ; the generic function-views are now deprecated.
All apps have been updated to use these new classes ; the function-views using old generic views have been deprecated (or sometimes removed).
- Lots of function-based views have been converted.
NB: removed functions are indicated in this changelog ; for the deprecated ones there are warnings.

Other important changes:
- The list-view action (for single & bulk actions) system has been totally reworked (Python & JavaScript sides).
Actions are now classes inheriting 'creme_core.gui.actions.UIAction', & are registered with 'CremeAppConfig.register_actions()' in your 'apps.py'.
So it's easier to add/override/remove them from another app.
- The registration of FunctionFields has been reworked. It's now external to the models (done in files 'apps.py' with 'CremeAppConfig.register_function_fields()') ;
so it's easier to add/override/remove them from another app.
- A new module, 'creme_core.core.enumerable', allows to retrieve & customise the choices related to a model-field.
It's used by list-views, filter form or ReportGraph.
- The old popup system is almost ready to be removed ; it's now only used by list-views & deprecated generic views ;
beware to use the new templates for popup when you use the new generic class-based views for popup
(if you don't set the attribute "template_name", the default value will be OK).
- The "qfilter" argument for list-view uses a new format, more powerful than the old one.
It's a true serialization of Q objects ; so 'OR' combinations can be used for example (only 'AND' were possible with the old format).

Non breaking changes :
----------------------
Deprecations :
- In 'creme_core.models' :
- The method 'entity.CremeEntity.allowed_unicode()' is deprecated ; use 'allowed_str()' instead.
- The class 'entity.EntityAction' is deprecated ; use 'creme_core.gui.actions.UIAction' and its registration mechanism instead.
- The function 'lock.mutex_autolock()' is deprecated ; use 'MutexAutoLock' as decorator instead.
- In 'creme_core.views' :
- The function-view 'generic.detailview.view_entity()' is deprecated ; use the class-based view 'EntityDetail' instead.
- In 'generic.add' :
- The function-view 'add_entity()' is deprecated ; use the class-based views 'CremeModelCreation' & 'EntityCreation' instead.
- The function view 'add_to_entity()' is deprecated ; use the class-based view 'AddingToEntity' instead.
- The function view 'add_model_with_popup()' is deprecated ; 'use the class-based view 'CremeModelCreationPopup' instead.
- In 'generic.edit' :
- The function-view 'edit_entity()' is deprecated ; use the class-based views 'CremeModelEdition' & 'EntityEdition' instead.
- The function-view 'edit_related_to_entity()' is deprecated ; use the class-based view 'RelatedToEntityEdition' instead.
- The function-view 'edit.edit_model_with_popup()' is deprecated ; use the class-based views 'CremeModelEditionPopup' & 'EntityEditionPopup' instead.
- In 'generic.listview' :
- In 'list_view()' & 'list_view_popup()', the format for the argument "qfilter" corresponding to 'get_q_from_dict()' is deprecated ;
use the new format which uses 'creme_core.utils.queries.Qserializer.dumps()' instead.
- The function '_clean_value()' is deprecated.
- The function-view 'generic.popup.inner_popup()' is deprecated ; use a class-based view instead.
- The function-view 'generic.portal.app_portal()' is deprecated.
- The function-view 'enumerable.json_list_enumerable()' is deprecated ; use the class-based view 'ChoicesView' instead.
- The function-view 'quick_forms.add()' is deprecated.
- The method 'creme_core.forms.creme_property._AddPropertiesForm._create_properties()' is deprecated.
- In the templatetag library "creme_core_tags" :
- {% get_field_verbose_name %} is deprecated ; use {% cell_4_regularfield %} from the lib "creme_cells" instead.
- {% get_viewable_fields %} is deprecated.
- The filter "|get_tag" is deprecated.
- The filter "|allowed_unicode" is deprecated ; use "|allowed_str" instead.
- The filter "|xrange" is deprecated ; use "|range" instead.
- The method 'creme_core.gui.menu.CreationFormsItem.verbose_unicode()' is deprecated ; use 'verbose_str()' instead.
- In 'creme_core.utils' :
- The function 'db.reorder_instances()' is deprecated ; use the class based-view 'creme_core.views.generic.order.ReorderInstances' instead.
- In 'queries.get_q_from_dict()', the "~" feature is deprecated ; use a 'django.db.models.query.Q' instead.
- The function 'chunktools.iter_splitlinechunks()' is deprecated (& broken if you pass bytes instead of str) ;
you can use the method 'django.core.files.base.File.__iter__()' instead for example.
- In 'creme_core.core' :
- The method 'reminders.ReminderRegistry.itervalues()' is deprecated ; use '__iter__()' instead.
- The class 'function_fields.FunctionFieldsManager' is deprecated ; use the new method 'CremeAppConfig.register_function_fields()' instead.
- 'creme_core.constants.MODELBLOCK_ID' is deprecated ; use 'MODELBRICK_ID' instead.
- The signal 'creme_core.signals.form_post_save' is deprecated.
- In 'creme_core.backends' :
- The method '_BackendRegistry.iterkeys()' is deprecated ; use the property '_BackendRegistry.extensions' instead.
- The method '_BackendRegistry.iterbackends()' is deprecated ; use the property '_BackendRegistry.backends' instead.
- These template files are deprecated :
- creme_core/generics/blockform/add_popup.html
- creme_core/generics/blockform/edit_popup.html
- creme_core/generics/blockform/link_popup.html
- creme_core/generics/blockformset/add_popup.html
- creme_core/generics/blockformset/base.html
- creme_core/generics/form/add_innerpopup.html
- creme_core/generics/form/edit_innerpopup.html
- creme_core/generics/inner_popup.html
- creme_core/generics/portal.html
- JavaScript:
- The function 'creme.utils.handleDialogSubmit()' is deprecated.
- The function 'creme.relations.addRelationTo' is now deprecated ; use 'creme.relations.AddRelationToAction' instead.
- Apps :
* Activities :
- These methods of 'models.AbstractActivity' are deprecated :
- display_review() (use <SettingValue.objects.get_4_key(setting_keys.review_key).value> instead)
- _get_linked_for_ctypes_aux()
- get_future_linked_for_ctypes()
- get_past_linked_for_ctypes()
- 'constants.DISPLAY_REVIEW_ACTIVITIES_BLOCKS' is deprecated ; use 'SETTING_DISPLAY_REVIEW' instead.
- The JavaScript function 'creme.activities.exportAsICal()' is deprecated ; use 'ExportAsICalAction' instead.
- These template files are deprecated :
- activities/view_activity_popup.html (use "activity-popup.html" instead).
- activities/add_popup_activity_form.html (use "forms/add-activity-popup.html" instead).
- activities/frags/ical_list_view_button.html
* Persons :
- In 'forms.contact.RelatedContactForm' :
- The use of initial values to fill "linked_orga" & "rtype" is deprecated ; use constructor argument instead.
- Leaving "linked_orga" argument empty is deprecated.
* Billing :
- 'constants.CURRENCY' is deprecated.
- The property 'models.AbstractTemplateBase.verbose_status' is deprecated.
- The method 'models.AbstractTemplateBase.get_verbose_status()' is deprecated ; use 'function_fields.TemplateBaseVerboseStatusField' instead.
- The method 'registry.AlgoRegistry.itervalues()' is deprecated ; use 'AlgoRegistry.algorithms' instead.
- The JavaScript function 'creme.billing.exportAs()' is deprecated ; use the action 'ExportDocumentAction' instead.
* Emails :
- The function 'views.sending.reload_mails_brick()' is deprecated ; use 'reload_sending_bricks()' instead.
- In 'forms.mail', the classes 'TemplateSelectionForm' & 'EntityEmailFromTemplateForm' are deprecated.
- These template files are deprecated :
- emails/popup_sending.html
- emails/view_email.html
- emails/view_entity_mail_popup.html
* Assistants :
- In the model 'Action' : the methods 'get_actions*()' are deprecated.
- In the model 'Alert' : the methods 'get_alerts*()' are deprecated.
- In the model 'Memo' : the methods 'get_memos*()' are deprecated.
- In the model 'ToDo' : the methods 'get_todos*()' are deprecated.
- In the model 'UserMessage' : the methods 'get_messages*()' are deprecated.
* Opportunities :
- The method 'models.AbstractOpportunity.get_weighted_sales()' is deprecated ; use 'function_fields.TurnoverField' instead.
- In 'forms.opportunity' :
- The class 'OpportunityCreateForm' is deprecated ; use 'OpportunityCreationForm' instead.
- The class 'OpportunityEditForm' is deprecated ; use 'OpportunityEditionForm' instead.
* Reports :
- The method 'report_aggregation_registry.FieldAggregationRegistry.itervalues()' is deprecated ; use the property 'FieldAggregationRegistry.aggregations' instead.
- The template file "reports/frags/report_export_filter.html" is deprecated ; use "forms/report-export-filter.html" instead.
* Commercial :
- The method 'models.CommercialApproach.get_approaches_for_ctypes()' is deprecated.
- The class 'forms.salesman.SalesManCreateForm' is deprecated.
* Geolocation :
- The function 'utils.get_setting()' is deprecated ; use 'SettingValue.objects.get_4_key()' instead.
* Tickets :
- The method 'models.AbstractTicket.get_resolving_duration()' is deprecated ; use 'function_fields.ResolvingDurationField' instead.
* SMS :
- The template file "sms/popup_sending.html" is deprecated.
A new hint, indicating when a swapped URL has never been defined, has been added (see 'creme.creme_core.conf.urls.Swappable') ;
it could "break" an existing application (because the code stops on a fatal error at starting), but it would indicate an existing bug.
The model 'creme_core.models.Relation' now explicitly avoids duplicates.
A new manager has been added, with 3 methods to handle this smoothly: safe_create(), safe_get_or_create() & safe_multi_save()
A new models field has been created : EntityCTypeForeignKey.
It looks like a GenericForeignKey, but it references only CremeEntities ; it uses a true ForeignKey for the entities, so it's possible to use classical filtering on FKs.
A specific manager has ben added to 'creme_core.models.SettingValue', with a method which keeps retrieved instances in a (per-request) cache.
A generic view to help the disabling of a URL has been added : the class-based view 'creme_core.views.generic.placeholder.ErrorView'.
A new collection has been added : 'creme_core.utils.collections.InheritedDataChain'.
It facilitates the writing of registries by models when data from parent classes are used too.
Two templatetags to store safely JSON data have been added : {% jsondata %} & {% blockjsondata %}.
A simple HTTP server has been added in unit tests to serve static files.
The command "i18n_empty" has been improved :
- The context is now used.
For example, an empty entry with a context is not ignored because an entry with he same 'msgid' (but without context) is filled.
- The line numbers in the PO files are now displayed.

Breaking changes :
------------------
Deprecated stuffs which have been removed :
- The app 'activesync' is not available any more (its code is still in the repository but has not been ported to Python 3).
- In all apps :
- The configurable portal views (i.e. not 'mobile', not 'creme_config') & their templates have been removed.
- The methods 'portal_display()' of Bricks have been removed.
- The method 'register_setting_key()' of classes inheriting 'CremeAppConfig' is not called automatically anymore.
- The middleware class 'creme_core.middleware.exceptions.Beautiful403Middleware' has been removed.
- In 'creme_core.models.bricks' :
- In 'BlockDetailviewLocation', the methods 'create()'/'create_empty_config()' & the attribute 'ZONES' have been removed.
- In 'BlockPortalLocation', the method 'create()' & 'create_empty_config()' have been removed.
- The method 'BlockMypageLocation.create()' has been removed.
- In 'creme_core.views' :
- The functions 'bricks.reload_portal()' & 'bricks.render_portal_brick()' have been removed.
- The function 'exceptions.server_error()' has been removed.
- The function 'file_handling.fetch_resources()' has been removed.
- In 'creme_core.forms.widgets' :
- These functions have been removed : widget_render_input(), widget_render_hidden_input(), widget_render_context().
- The method 'EnhancedSelectOptions.render_label()' has been removed.
- In 'creme_core.gui' :
- The old API (activated by 'settings.OLD_MENU == True') in 'menu' has been removed.
- In 'bricks' :
- In 'BricksManager', the methods 'get_dependencies_map()' & '_get_dependencies_ids()' have been removed.
- The method '_BrickRegistry.get_compatible_portal_blocks()' has been removed.
- The attribute 'Brick.target_apps' has been removed.
- In 'buttons.ButtonsRegistry.register()', registering 'Button' instances is no more possible.
In all apps the global buttons instances have been removed.
- In 'creme_core.utils.dates', these deprecated functions have been removed :
- get_dt_to_iso8601_str()
- get_dt_from_iso8601_str()
- get_dt_from_json_str()
- dt_to_json_str()
- get_dt_from_str()
- get_date_from_str()
- These constants of 'creme_core.constants' have been removed :
- SETTING_BLOCK_DEFAULT_STATE_IS_OPEN
- SETTING_BLOCK_DEFAULT_STATE_SHOW_EMPTY_FIELDS
- In 'creme_core.core.reminders.ReminderRegistry.register()', registering an instance is not possible anymore.
- In 'creme_core.registry' :
- The exception class 'NotRegistered' has been removed.
- In 'CremeRegistry', the methods 'register()' & 'get()' have been removed.
- In 'bricks.HistoryBrick', the method '_populate_users()' has been removed.
- In 'creme_core.templatetags' :
- These templatetags have been removed : {% timedelta_pprint %}, {% ctype_is_registered_for_import %}, {% get_button_menu %}.
- In 'creme_bricks', about the tag {% brick_display %}, the option "render='portal'" has been removed.
- The templatetag 'creme_listview.get_listview_columns_header' does not inject the variable "can_merge_entities" in the context any more.
- In 'creme_menu' :
- The old menu API has been removed.
- The tags {% get_prefered_menu %} & {% get_last_items_menu %} have been removed with their templates.
- In 'creme_search', the tag {% get_search_panel %} has been removed.
- The templatetags library "creme_quickforms" has been removed (its only templatetag was deprecated).
- In JavaScript :
- In 'creme.utils', the functions 'openQuickForms()' & 'confirmBeforeGo()' have been removed.
- In 'creme.menu' :
- The global variable 'actions' has been removed.
- The functions 'NavIt()' & 'HNavIt()' have been removed ; the lib "jquery.navIt.0.0.6.js" has been removed too.
- The function 'creme.menu.sideMenu()' has been removed ; the related lib "fg.menu" has been removed too.
- Apps :
* Creme_config :
- In 'views.bricks' :
- The class 'PortalBricksWizard' has been removed.
- The function 'edit_portal()' & 'delete_portal()' have been removed.
- In 'forms.bricks' :
- The method '_BrickLocationsForm._build_portal_locations_field()' has been removed.
- These classes have been removed: _BlockPortalLocationsForm, BlockPortalLocationsAddForm & BlockPortalLocationsEditForm.
- The function 'utils.generate_portal_url()' has been removed.
* Documents :
- In 'views.ajax', the functions 'get_child_documents()' & 'get_child_documents()' have been removed.
* Activities :
- In the view 'calendar.get_users_activities()', the URL argument "calendar_ids" has been removed.
- In 'bricks', the methods 'FutureActivitiesBrick._get_queryset_for_ctypes()' & 'PastActivitiesBrick._get_queryset_for_ctypes()' have been removed.
* Assistants :
- The method 'bricks._AssistantsBrick._get_contenttype_id()' has been removed.
- All the methods '_get_queryset_for_portal()' of the Bricks have been removed.
- The global variables 'reminders.reminder_alert' & 'reminders.reminder_todo' have been removed.
* Emails :
- The class 'bricks.SignaturesBrick' has been removed.
The settings "OLD_MENU" & "LOGO_URL" have been removed.
In the credentials system, the hack with the fake app "my_page" (access was always allowed) has been removed.
In 'creme_core.models' :
- The classes 'entity.CremeEntity' & 'relation.Relation' now inherit 'base.CremeModel'.
- The class 'base.CremeAbstractEntity' has been removed.
- The global constant 'base._SEARCH_FIELD_MAX_LENGTH' has been moved to 'entity'.
- In the model 'Relation' :
- These fields have been removed : entity_type, header_filter_search_field, is_deleted, modified.
- These attributes have been removed : _real_entity, function_fields.
- These methods have been removed : _get_real_entity(), get_real_entity(), populate_real_entities().
- The method 'CremeEntity.get_actions()' has been removed ; use the new action system ('creme_core.gui.actions') instead.
- The attribute 'CremeEntity.function_fields' has been removed ; use 'creme_core.core.function_fields.function_field_registry' instead.
- The class 'entity._PrettyPropertiesField' has moved to 'creme_core.function_fields.PropertiesField'.
- The model 'relation.Relation' has now a UNIQUE constraint on ('type', 'subject_entity', 'object_entity') ;
a data migration removes duplicated relations, so beware to custom code which (accidentally) relies on duplicated Relation (e.g. with internal RelationType).
- The field 'creme_property.CremePropertyType.is_custom' is <editable=False> now.
- These models of 'bricks' have been renamed :
- BlockDetailviewLocation => BrickDetailviewLocation
- BlockPortalLocation => BrickPortalLocation
- BrickMypageLocation => BrickMypageLocation
- RelationBlockItem => RelationBrickItem
- InstanceBlockConfigItem => InstanceBrickConfigItem
- CustomBlockConfigItem => CustomBrickConfigItem
- BlockState => BrickState
- The field 'bricks.BrickPortalLocation.app_name' has been removed.
- The method 'bricks.BrickPortalLocation.create_or_update()' has been removed.
- The model 'PreferedMenuItem' has been removed.
In 'creme_core.views' :
- These function-views have been replaced by class-based views :
- creme_property : type_detailview(), add_to_entity(), add_properties_bulk(), add_type(), edit_type()
- entity : inner_edit_field(), bulk_update_field(), trash()
- entity_filter : add(), edit()
- header_filter : add(), edit()
- index : home(), my_page()
- job : detailview(), edit(), list_all(), list_mine()
- quick_forms.add_from_widget()
- relation : add_relations(), add_relations_bulk()
- search.search()
In 'creme_core.forms' :
- In 'fields' :
- The method 'CreatorEntityField._check_qfilter()' has been removed.
- Some error messages in 'RelationEntityField' get an argument.
- The class 'header_filter.HeaderFilterForm' has been removed ; use the 'HeaderFilterCreationForm' & 'HeaderFilterEditForm' instead.
- In 'entity_filter' :
- The constructor of 'EntityFilterCreateForm' takes a additional mandatory argument "ctype" (& it does not use the initial data to get the content type).
- The constructors of 'FieldConditionWidget' & 'RegularFieldsConditionsWidget' take now an additional first argument "model" (default: CremeEntity).
In 'creme_core.gui' :
- With the method 'quick_forms.QuickFormsRegistry.register()' : if a form is already registered for the given model, an exception is raised (there was just a log).
- The method 'button_menu.ButtonsRegistry.get_buttons()' is now a generator.
In 'creme_core.utils' :
- The decorator 'jsonify' has moved to the module 'creme_core.views.decorators'.
- A new default JSON encoder has been added : 'creme.creme_core.utils.serializers.json_encode()'.
The output of "jsonify", "{% ...|jsonify %}" & "{% brick_action %}" has slightly changed for date/datetime/time formatting.
- The function 'safe_unicode_error()' has been removed.
- In 'collections.ClassKeyedMap', the methods 'items()', 'keys()' & 'values()' now return 'views' like regular Python3 dictionaries.
- The method 'date_range.DateRangeRegistry.register()' now raises an Exception for duplicates (previously it was just a log message).
- In 'date_period' :
- The method 'DatePeriodRegistry.register()' now raises an Exception for duplicates (previously it was just a log message).
- The method 'SimpleValueDatePeriod._ungettext()' must now return a '{number}' format string (it was a '%s' format).
- The function 'secure_filename.secure_filename()' uses only 'str' (not 'bytes').
- The module 'unicode_csv' has been removed ; use the standard module 'csv' instead.
About context processors :
- The function 'creme_core.context_processors.get_old_menu()' & 'creme_core.context_processors.get_logo_url()' have been removed.
- The variable 'DEFAULT_THEME' is not injected in the templates context anymore (see processor 'get_css_theme()').
In 'creme_core.core' :
- The constructor of 'entity_cell.EntityCellActions' takes an additional argument : "actions_registry".
- In the class 'reminders.ReminderRegistry' :
- The method 'register()' now raises a 'ReminderRegistry.RegistrationError' when an ID is duplicated (it was just a log message).
- The method 'unregister()' now raises a 'ReminderRegistry.RegistrationError' when an ID des not exist (it was just a log message).
- The method '__iter__()' now returns instances of Reminders (it was tuples (ID, instance_of_reminder)) like 'itervalues()'.
- The method 'setting_key._SettingKeyRegistry.unregister()' now raises an exception in an ID is not registered (it was a simple log message).
The templatetag {% get_entity_actions %} (from "creme_widgets") has been removed ;
use {% listview_entity_actions %} & {% listview_header_actions %} (from "creme_listview") instead.
In the template 'creme_core/view_property_type.html', the variable for bricks is now "bricks" (it was still "blocks").
JavaScript :
- The function 'creme.dialogs.image()' now returns a 'creme.dialog.ImagePopover' instance.
- Use the event "brick-setup-actions" for custom brick action registration instead of "brick-before-bind".
- The method 'creme.widget.EntitySelector.multiple()' has been removed ; used 'isMultiple()' instead.
- The jQuery extension 'imageMagnifier' is not used any more and has been removed from the default configuration.
Apps :
* Creme_config :
- Some URLs have changed (no problem if named URLs are used):
- "creme_config/blocks/relation_block/*" => "creme_config/bricks/rtype/*"
- "creme_config/blocks/instance_block/*" => "creme_config/bricks/instance/*".
- "creme_config/blocks/*" => "creme_config/bricks/*".
- In 'views':
- Many function-views have been replaced by Class-Based Views.
- The class 'user_role.UserRoleCreationWizard' has been renamed 'RoleCreationWizard'.
- The class 'user_role.UserRoleEditionWizard' has been renamed 'RoleEditionWizard'.
- The function 'bricks._edit_mypage()' has been removed.
- In 'forms' :
- The constructor of 'custom_fiels.CustomFieldsAddForm' takes an additional mandatory argument "ctype".
- The constructor of 'search.SearchAddForm' takes an additional mandatory argument "ctype".
- The method 'user.UserAssignationForm.save()' does not lock any more (this is done by the view 'UserDeletion', with another lock name).
- In 'bricks' :
- The forms do not use "self.initial" to initialize their attributes ("content_type", "role" & "superuser").
- In the class 'BrickMypageLocationsForm', the field "blocks" has been renamed "bricks".
- In 'user_role' :
- The constructor of 'AddCredentialsForm': the argument "role" has been replaced by an argument "instance".
- About 'UserRoleDeleteForm' :
- The constructor takes an additional argument "instance", & does not use the initial value "role_to_delete" any more.
- The method 'save()' does not use a lock (this is done by the view 'RoleDeletion', with another lock name).
- All views/forms/bricks/templates about 'PreferedMenuItem' have been removed.
- The class 'brick.BlockPortalLocationsBrick' has been removed with its related template.
- In 'templates'
- The template file "creme_config/portal.html" has changed (e.g. suppression of {% block before_statistics %}).
- The template "creme_config/generics/app_portal.html" has been replaced by "app-portal.html" to make some changes (e.g. use the variable "bricks" instead of "app_config_bricks").
- The template "creme_config/generics/model_portal.html" has been replaced by "model-portal.html" to make some changes (e.g. use the variable "bricks" instead of "model_brick").
- In 'bricks', these classes have been renamed :
- BlockDetailviewLocationsBrick => BrickDetailviewLocationsBrick
- BlockHomeLocationsBrick => BrickHomeLocationsBrick
- BlockDefaultMypageLocationsBrick => BrickDefaultMypageLocationsBrick
- BlockMypageLocationsBrick => BrickMypageLocationsBrick
- RelationBlocksConfigBrick => RelationBricksConfigBrick
- InstanceBlocksConfigBrick => InstanceBricksConfigBrick
- CustomBlocksConfigBrick => CustomBricksConfigBrick
* Persons :
- In the models 'Address' :
- The field "object_id" (PositiveIntegerField) have been replaced by the field "object" (EntityCTypeForeignKey).
- The field "owner" is not a 'GenericForeignKey' anymore ; it's a 'RealEntityForeignKey'.
- The related name for the field "content_type" has been removed.
- The URL "persons/contact/add_with_relation/" has been replaced by "persons/contact/add_related/" (but the name did not change) ;
the argument "callback_url" is not used any more.
- The function 'views.organisation.set_managed()' has been removed ; use the class-based view 'ManagedOrganisationsAdding' instead.
* Documents :
- In 'views' :
- The function-views 'document.abstract_add_related_document()' & 'add_related()' has been removed ; use the class-based view 'RelatedDocumentCreation' instead.
- The function-views 'folder.abstract_add_child_folder()' & 'add_child()' has been removed ; use the class-based view 'ChildFolderCreation' instead.
- In 'forms' :
- The class 'document.RelatedDocumentCreateForm' constructor takes an additional argument "entity" (& does not use the initial value with key="entity" any more).
- The class 'folder.ChildFolderForm' constructor takes an additional argument "entity" (& does not use the initial value with key="parent" any more).
- In the class 'fields.(Multi)ImageEntityField', the property "q_filter" is now a Q() instance (even if you set a dictionary).
* Activities :
- These function-views have been removed & replaced by class-based views :
- bricks.add_participant()
- bricks.add_subject()
- calendar.add_user_calendar()
- edit_user_calendar()
- link_user_calendar()
- The method 'forms.mass_import.RelatedExtractor._searched_contact()' returns now a Contact instance, & not a tuple anymore.
* Assistants :
- In 'models' Action/Alert/Memo/ToDo/UserMessage :
- The PositiveIntegerFields "entity_id" have been replaced by EntityCTypeForeignKeys "entity".
- The fields 'creme_entity' are not 'GenericForeignKeys' anymore ; they are 'RealEntityForeignKeys' now.
- The related names for the fields 'entity_content_type' have been removed.
- The class 'models.alert._GetAlerts' has moved to 'function_fields.AlertsField'.
- The class 'models.memo._GetMemos' has moved to 'function_fields.GetMemosField'.
- The class 'models.todo._GetTodos' has moved to 'function_fields.GetTodosField'.
- All views using 'creme_core.views.generic.add_to_entity()' has been removed & replaced by Class-Based Views.
The function-view 'user_message.add()' has been replaced too.
* Products :
- The function 'views.product.add_images()' has been removed ; use the class-based view 'ImagesAdding' instead.
- The function 'views.service.add_images()' has been removed ; use the class-based view 'ImagesAdding' instead.
* Billing :
- The URL for the list-view of CreditNotes has change (but its name did not change, so no breaking with 'reverse()').
- The class 'models.templatebase._VerboseStatusField' has moved to 'function_fields.TemplateBaseVerboseStatusField'.
- The function 'views.payment_information.add()' has been removed ; use the class-based view 'PaymentInformationCreation' instead.
- The function 'views.line.add_to_catalog()' has been removed ; use the class-based view 'AddingToCatalog' instead.
- The function 'views.payment_information.edit()' has been removed ; use the class-based view 'PaymentInformationEdition' instead.
- The method 'registry.AlgoRegistry.register()' now raises an Exception on duplicated IDs (it was a simple log message).
- The templates "billing/frags/button_convert2invoice.html" & "billing/frags/button_convert2order.html" do not use the variable "has_perm" any more.
* Opportunities :
- The class 'models._TurnoverField' has moved to 'function_fields.TurnoverField'.
- The JavaScript function 'creme.opportunities.setCurrentQuote()' has been removed.
* Emails :
- The URL for the views "emails__view_sending" has changed (the prefix "campaign/" has been removed) ; there is no breaking if you use 'reverse()'.
- The field 'models.LightWeightEmail.body' contains now JSON data instead of pickled data.
- These function views have been replaced by class-based views :
- campaign.add_ml()
- crudity.synchronisation()
- mail.view_lightweight_mail()
- mailing_list : add_contacts(), add_contacts_from_filter(), add_children(), add_organisations(), add_organisations_from_filter()
- recipient : add(), add_from_csv()
- sending : add(), detailview()
- signature : add(), edit()
- template.add_attachment()
* Commercial :
- The URL named "commercial__edit_segment_desc" has changed & takes only one argument now.
- In the model 'CommercialApproach' :
- The field 'ok_or_in_futur' has been removed.
- The PositiveIntegerField 'entity_id' has been replaced by the EntityCTypeForeignKey 'entity'.
- The field 'creme_entity' is not a 'GenericForeignKey' anymore ; it's a 'RealEntityForeignKey'.
- The related name for the field 'entity_content_type' has been removed.
- The static method 'get_approaches()' does not return instances related to deleted (i.e. in the trash) entities when not entity PK is given.
- In views, these function-views have been removed & replaced by class-based views :
- act : add_pattern_component(), add_objective(), add_objectives_from_pattern(), _add_objective(), edit_objective()
add_child_pattern_component(), add_parent_pattern_component(), create_objective_entity().
- strategy : add_segment(), edit_segment(), link_segment(), add_asset(), edit_asset(), add_charm(), edit_charm(), add_evalorga(), orga_evaluation(), orga_synthesis()
- market_segment : add(), edit(), delete(), listview()
- The function 'views.strategy._orga_view()' has been removed.
- The function 'views.act._add_subpattern_component()' has been removed.
- The constructor of 'forms.market_segment.SegmentReplacementForm' takes an additional argument "instance".
* Reports :
- In 'views' :
- In 'report.set_selected()', a new POST argument is mandatory: "report_id".
So the JavaScript function 'creme.reports.expandSubReport()' takes an additional argument "report_id".
- The function-view 'report.edit_fields' has been removed ; use the class-based view 'FieldsEdition' instead.
- The function-view 'report.reorder_field()' has been removed ; use the class-based view 'MoveField' instead.
The related URL has changed (the name remains the same, but the report's ID must be added in arguments).
- The function-view 'export.preview()' has been removed ; use the class-based-view 'Preview' instead.
- In the constructor of 'forms.report.ReportFieldsForm', the argument "entity" has been renamed "instance".
- The attribute 'report_aggregation_registry.FieldAggregation.pattern' must now be a {}-format string.
- In the class 'core.graph.ReportGraphHand' (& so child classes), the methods 'fetch()' & '_fetch()' take a mandatory argument "user".
- In JavaScript:
- These functions have been removed : creme.reports.load(), creme.reports.loadHeaderFilters() & creme.reports.loadEntityFilters().
- The signature of 'creme.reports.exportReport(filterform_url, preview_url, export_url)' has changed to 'creme.reports.exportReport(filterform_url)'.
- The signature of 'creme.reports.PreviewController(preview_url, export_url)' has changed to 'creme.reports.PreviewController({previewUrl: ..., exportUrl: ...})'.
* Geolocation :
- In 'bricks.GoogleDetailMapBrick', the context variable "geoaddresses" is not JSON-ified any more.
* Tickets :
- The class 'models._ResolvingDurationField' has moved to 'function_fields.ResolvingDurationField'.
- The button 'buttons.Linked2TicketButton' does not inject the variable "ticket_ct" any more.
* Crudity :
- In the class 'models.WaitingAction', the methods 'get_data()' & 'set_data()' have been removed ; use the property 'WaitingAction.data' instead.
- The function-view 'views.actions.portal()' has been removed ; use the class-based view 'Portal' instead.
- The function-view 'views.history.history()' has been removed ; use the class-based view 'History' instead.
- The function 'utils.strip_html_()' has been removed ; use 'strip_html()' instead.
- The unused function 'utils.unescape()' has been removed.
* Graphs :
- The function 'views.graph.add_relation_types()' has been removed ; use the class-based view 'RelationTypesAdding' instead.
- The function 'views.root_nodes.add()' has been removed ; use the class-based view 'RootNodesAdding' instead.
- The function 'views.root_node.edit()' has been removed ; use the class-based view 'RootNodeEdition' instead.
* Projects :
- These function-views have been replaced by class-based views :
- resource : add(), edit()
- task : abstract_add_activity(), add_activity(), task.add_parent()
- In 'forms.task.RelatedActivityCreateForm', the constructor takes an argument "entity" now.
* Polls :
- These function views have been replaced by class-based views :
- poll_form : add_line(), add_section(), add_line_to_section(), add_section_child(),
edit_line_conditions(), edit_line(), edit_section(), stats()
- poll_preply : link_to_person(), edit_line()
- In 'forms.poll_form':
- The method 'PollFormSectionCreateForm.save()' does not use <self.initial['parent']> any more ; use the constructor argument "line" instead.
- The constructor of 'PollFormLineCreateForm' takes now an optional argument "section" & does not use <self.initial['line']> any more.
- The constructor of 'poll_form.PollFormLineEditForm' does not raise a 404 error when the related line is disabled any more.
- The constructor of 'PollFormLineConditionsForm' takes an additional argument "line" & does not use <self.initial['line']> any more.
- In the class 'core.EnumPollLineType', the attributes '_description' & '_description_del' use now '{foo}' format.
* Events :
- The constructor of 'forms.event.RelatedOpportunityCreateForm' takes 2 additional arguments "event" & "contact" ; the initial values with keys "event" & "contact" are not used any more.
* Vcfs :
- In 'forms.vcf', 'VcfImportForm.HOME_ADDR_PREFIX' & 'VcfImportForm.WORK_ADDR_PREFIX' moved at the root of the module.
* CTI :
- The function-view 'views.respond_to_a_call()' has been removed ; use the class-based view 'AnswerToACall' instead.
- In 'views._build_related_phonecall()', the title format in now a '{entity}' format string.
* SMS :
- The function-view 'views.sending.detailview()' has been removed ; use the class-based view 'Messages' instead.

Internal breaking changes :
---------------------------
(they should not cause problem if you have not deeply modified the source code of Creme)

In 'creme_core.models' :
- In 'history', the attributes '_HLTPropertyCreation._fmt' & '_HLTRelation._fmt' use now {}-format strings.
- In 'entity_filter._ConditionOperator', "key_pattern" (argument and property) is now a {}-format string.
In 'creme_core.views' :
- The functions 'entity_filter._set_current_efilter()' & 'header_filter._set_current_hf()' have been removed.
- The function 'index._render_home()' has been removed.
In 'creme_core.forms': 'base._CUSTOM_NAME' & 'bulk._CUSTOMFIELD_FORMAT' are now {}-format strings.
In the attribute 'creme_core.core.entity_cell.EntityCellCustomField._CF_PATTERNS', values are now {}-format strings.
The class 'creme_core.backends.csv_import.CSVImportBackend' does not inherit 'UnicodeReader' any more.
In the constructor of 'creme_core.gui.bricks.SpecificRelationsBrick', the argument "relationblock_item" has been renamed "relationblock_item".
In 'creme_core.templatetags' :
- The return of 'creme_bricks.brick_action()' has slightly changed ("data" key is now a dict/None, not a string any more).
- In the function 'creme_listview._build_select_search_widget()' : the argument "choices" uses the new dictionary format
for choices (see 'creme_core.core.enumerable.Enumerator') & the "values" of the widget context uses a new format adapted for grouped choices ;
the template 'creme_core/templatetags/listview_columns_header.html' has changed to use this new format.
The functions 'python_subprocess()' in 'creme_core.utils.system.nt' & 'creme_core.utils.system.posix' have been removed (replaced by the one in 'creme_core.utils.system').
The signal with uid "creme_core-blockmypagelocation._copy_default_config" is now "creme_core-brickmypagelocation._copy_default_config".
Some patterns in 'creme_core.utils.url.TemplateURLBuilder' have changed to be {}-format strings.
In JavaScript, all "_action_*" methods in 'ListViewActionBuilders' have been renamed to "_build_*" (see 'ActionBuilderRegistry' API).
Apps :
* Creme_config :
- The function 'views.bricks._get_configurable_ctype()' has been removed.
- The function 'views.generics_views._popup_title()' has been removed.
- In the constructor of 'registry._ConfigRegistry', the argument "block_registry" has been renamed "brick_registry".
* Persons :
- The method 'forms.merge._PersonMergeForm._save_address()' has been replaced by '_handle_addresses()'.
* Billing :
- The function 'function_fields.hook_organisation()' has been removed.
* Emails :
- The function 'views.sending._get_sending()' is deprecated.
- The template "emails/bricks/html-body.html" needs a context variable "body_url" now.
* Crudity :
- The field 'models.WaitingAction.raw_data' is now a BinaryField.
- The global variable 'builders.infopath.XSL_VIEW_FIELDS_TEMPLATES_PATH' is now a {}-format string.
- The method 'builders.infopath.InfopathFormBuilder._render()' is not a generator anymore & takes a mandatory argument "file_name".
- In JavaScript, the brick-actions no longer use the argument "__selector".
* Assistants :
- In 'signals' : 'MODELS', 'dispose_instances()' & 'handle_merge()' have been removed.
* Commercial :
- In 'signals', the function 'dispose_comapps()' & 'handle_merge()' have been removed.
* Geolocation :
- The method 'management.commands.geolocation.CSVPopulator._open()' has been removed.

Non breaking changes :
----------------------
Deprecations :
- From Django 1.10 :
- The module 'django.core.urlresolvers' is deprecated (use 'django.urls' instead).
- In 'creme_core.models.CremeUser', 'is_authenticated()' & 'is_anonymous()' as method are deprecated (use them as property).
- The direct assignment to the forward side of a many-to-many set is deprecated (use the method 'set()' instead).
- From Django 1.11 :
- The view 'django.contrib.auth.views.login()' is now deprecated ; so we use the class-based view 'LoginView'.
- The middleware class 'creme_core.middleware.exceptions.Beautiful403Middleware' is deprecated.
- In 'creme_core.views' :
- The function 'exceptions.server_error()' is deprecated (use 'django.views.defaults.server_error()' instead).
- The function 'file_handling.fetch_resources()' is deprecated (it was not used for a long time).
- The functions 'bricks.reload_portal()' & 'bricks.render_portal_brick()' are deprecated.
- In 'creme_core.models' :
- In 'bricks.BlockDetailviewLocation' :
- The methods 'create_empty_config()' & the attribute 'ZONES' are deprecated.
- The method 'create()' is deprecated (use create_if_needed() instead).
- In 'bricks.BlockPortalLocation' :
- The method 'create()' is deprecated (use create_or_update() instead).
- The method 'create_empty_config()' is deprecated.
- The method 'bricks.BlockMypageLocation.create()' is deprecated (use 'bricks.BlockMypageLocation.objects.create()' instead).
- In 'creme_core.forms.widgets' :
- These functions are now deprecated : widget_render_input(), widget_render_hidden_input(), widget_render_context().
- The method 'EnhancedSelectOptions.render_label()' is deprecated.
- In 'creme_core.gui' :
- The old menu API is deprecated.
- In 'bricks' :
- In 'BricksManager', the methods 'get_dependencies_map()' & '_get_dependencies_ids()' are now deprecated.
- The attribute 'Brick.target_apps' is deprecated.
- The method '_BrickRegistry.get_compatible_portal_blocks()' is deprecated.
- In 'buttons.ButtonsRegistry.register()', registering 'Button' instances is deprecated (register classes instead).
In all apps with global buttons instances, these ones are deprecated.
- The method 'HistoryBrick._populate_users()' is deprecated (use 'HistoryLine.populate_users()' instead).
- In 'creme_core.core.reminders.ReminderRegistry.register()', registering an instance is deprecated; register a class instead.
- In 'creme_core.registry' :
- The exception class 'NotRegistered' is now deprecated.
- The methods 'register()' & 'get()' of 'CremeRegistry' are now deprecated.
- In 'creme_core.templatetags' :
- {% timedelta_pprint %} is deprecated (use {% date_timedelta_pprint %} instead).
- In the library 'creme_bricks', in {% brick_display %}, the option "render='portal'" is deprecated.
- In the library 'creme_menu' :
- The tags activated by <settings.OLD_MENU = True> are deprecated.
- {% get_last_items_menu %} & {% get_prefered_menu %} are deprecated (their template too).
- {% get_button_menu %} is deprecated (use {% menu_buttons_display %} instead).
- {% ctype_is_registered_for_import %} (use the filter "ctype_can_be_mass_imported" (from the library 'creme_ctype') instead).
- In the library 'creme_search', the tag {% get_search_panel %} (& is template) is deprecated.
- The templatetags library "creme_quickforms" is deprecated.
- In JavaScript :
- The function 'creme.utils.confirmBeforeGo()' is deprecated.
- In 'creme.menu' :
- The variable 'actions' is deprecated.
- The functions 'sideMenu()', 'NavIt()' & 'HNavIt()' are deprecated.
- In all apps, the methods 'portal_display()' of Bricks are deprecated.
- Apps :
* Creme_config :
- The function 'utils.generate_portal_url()' is deprecated.
- In 'views.bricks' :
- The class-view 'PortalBricksWizard' is deprecated.
- The function-views 'delete_portal()' & 'edit_portal()' are deprecated.
- In 'forms.bricks' :
- The classes '_BlockPortalLocationsForm', 'BlockPortalLocationsAddForm' & 'BlockPortalLocationsEditForm' are deprecated.
- The method '_BrickLocationsForm._build_portal_locations_field()' is deprecated.
* Documents :
- In 'views.ajax', the function 'get_child_documents()' & 'get_child_documents()' are deprecated.
* Activities :
- In the view 'calendar.get_users_activities()', the URL argument "calendar_ids" is deprecated (use the GET parameter "calendar_id" instead).
- In 'bricks', the methods 'FutureActivitiesBrick._get_queryset_for_ctypes()' & 'PastActivitiesBrick._get_queryset_for_ctypes()' are deprecated.
* Assistants :
- The method 'bricks._AssistantsBrick._get_contenttype_id()' is deprecated.
- All the methods '_get_queryset_for_portal()' of the Bricks are deprecated.
- The global variables 'reminders.reminder_alert' & 'reminders.reminder_todo' are deprecated.
* Emails :
- 'bricks.SignaturesBrick' is deprecated.
Django 1.11 raises UnorderedObjectListWarning warnings when the pagination is made on a unordered queryset ; some models were missing a Meta.ordering.
A model FileRef has been added ; it provides a way to remove an old bug with deletion of model referencing files.
The related files were automatically delete when instances were deleted, so it caused problems when the DB deletion was rollbacked.
Now a FileRef, which references the file, is created at deletion (so it's creation is cancelled on a rollback) and the new file cleaner Job will delete these FileRef instance (& the related file).
FileRef will be useful in the future for files created dynamically (like in export views).
Some template filters have been added in 'creme_core_tags' : lt, lte, gt, gte, eq.
The test runner now creates a mock/temporary 'settings.MEDIA_ROOT' directory. So the files created in unit tests (e.g. uploaded files) are not spoiling the real 'upload/' directory.
This temporary directory is removed at the end of tests ; there is no need to take care about deleting only the tests files any more.
In JavaScript :
- The option "validator" in 'creme.dialog.FormDialog' now accepts the value "innerpopup" to continue to handle old-styled-popup HTML (<div class="in-popup" ...>)

Breaking changes :
------------------
Deprecated stuffs which have been removed :
- In all apps, the modules 'blocks' have been removed, & the related template files too.
- The setting 'DEFAULT_THEME' has been removed.
- 'creme_core.constants.PROP_IS_MANAGED_BY_CREME' & 'creme_core.constants.ICON_SIZE_MAP' have been removed.
- The method 'CremeAppConfig.register_blocks()' is no called automatically anymore.
- These modules have been removed: gui.block, gui.icon_registry, models.block & views.blocks.
- The variable 'creme_core.urls.blocks_patterns' has been removed
- In 'creme_core.models' :
- The field 'SettingValue.user' has been removed.
- These methods have been removed : CremeEntity.populate_fk_fields(), BlockDetailviewLocation.create_4_model_block(),
CustomBlockConfigItem.id_from_block_id(), BlockState.get_for_block_id(), BlockState.get_for_block_ids() & SettingValue.create_if_needed().
- These properties have been removed : BlockMypageLocation.block_verbose_name, InstanceBlockConfigItem.block & BlockState.classes.
- In 'creme_core.views' :
- These functions have been removed :
- generic.listview.list_view_popup_from_widget().
- creme_property.reload_block().
- entity.bulk_edit_field() (use 'bulk_update_field()' instead).
- list_view_export.dl_listview_header().
- quick_forms.json_quickform_response().
- relation.objects_to_link_selection().
- search.reload_block().
- These arguments have been removed :
- "entity1_id" in 'entity.select_entity_for_merge()'.
- "entity1_id" & "entity2_id" in 'entity.merge()'.
- "ct_id" & "include_all" in 'entity_filter.get_for_ctype()'.
- "ct_id" in 'header_filter.get_for_ctype()'.
- "ct_id" & "doc_type" in 'list_view_export.dl_listview()'.
- "count" in 'quick_forms.add_from_widget()'.
- "relations_types" in 'relation.add_relations_bulk()'.
- In 'creme_core.forms' :
- The fields 'CremeDateField', 'CremeTimeField' & 'CremeDateTimeField' have been removed.
- The support for non-iterable values as "allowed_models" argument for the property '[Multi]GenericEntityField.allowed_models' has been removed.
- The argument "choices" of 'fields.DatePeriodField.__init__()' has been removed.
- The method 'merge.MergeField.set_merge_initial()' has been removed.
- In 'creme_core.gui' :
- In 'bricks':
- The method 'get_block_template_context()' of 'Brick/PaginatedBrick/QuerysetBrick' has been removed.
- The method 'BricksManager.block_is_registered()' has been removed.
- In _BrickRegistry :
- These methods have been removed : get_blocks(), get_block_4_instance(), get_block_4_object(), get_compatible_blocks().
- The possibility to register instances with 'register()' & register_4_model()' has been removed.
- The possibility to register a brick class which has an ID with 'register_4_model()' has been removed.
- In 'fields_config.FieldsConfigRegistry', the method 'is_model_valid()' & the property 'ctypes' have been removed.
- In 'field_printers' these methods have been removed: simple_print(), print_image(), print_boolean(), print_urlfield(), print_foreignkey(), print_many2many().
- The method 'icons.IconRegistry.get()' has been removed.
- In 'creme_core.templatetags' :
- The libraries 'creme_block' & 'creme_queryset' have been removed.
- In the library 'creme_widgets' :
These tags have been removed : {% get_image_for_ctype ... %}, {% get_image_path_for_ctype ... %} & {% get_image_for_object ... %}.
These tags (& their related template file) have been removed :
{% get_add_button %}, {% get_edit_button %}, {% get_delete_button %}, {% get_restore_button %}, {% get_clone_button %}.
- The functions '_get_image_path_for_model()' & '_get_image_for_model()' have been removed.
- In the library 'creme_listview', the tag {% get_listview_cell %} have been removed.
- In bricks.PropertiesBrick, the variable "ct_id" is not injected anymore in the template context.
- These template files of 'creme_core' have been removed :
templatetags/blocks_dependencies.html, generics/blockform/add_popup2.html, batch_process_report.html, importing_report.html .
- The context processor 'creme.creme_core.context_processor.get_blocks_manager' has been removed.
- These functions of 'creme_core.utils' have been removed:
is_testenvironment(), imports.find_n_import(), media.get_current_theme_vb(), meta.get_instance_field_info().
- The button 'creme_core.buttons.MergeEntitiesButton' (& the related template too) have been removed.
- In JavaScript :
- These functions have been removed : creme.component.is(), creme.object.isempty(), creme.object.isnone().
- In 'creme.utils', these functions have been removed :
innerPopupNReload(), toggleCheckallState(), autoCheckallState(), decorateSearchResult(), getBlocksDeps().
- The module 'creme.blocks' has been removed.
- In 'creme.exports.exportAs()' the URL cannot be a format string anymore.
- In 'creme.lv_widget', these functions have been removed : deleteEntityFilter(), deleteHeaderFilter().
- The function 'creme.merge.selectOtherEntityNRedirect()' has been removed.
- In 'creme.relations.addRelationTo()', the option "blockReloadUrl" & the hard-coded URLs support have been removed.
- In 'creme_core.tests.base._CremeTestCase', the methods 'populate()' & 'build_bulkedit_url()' have been removed.
- Apps :
* Creme_config :
- In registry.AppConfigRegistry, the method 'register_block()' & the property 'blocks' have been removed.
- In registry._ConfigRegistry :
- The methods 'register_blocks()' & 'register_userblocks()' & property 'userblocks' have been removed.
- In the methods 'register_bricks()' & 'register_user_bricks()', the support of registering instances (instead of classes) has been removed.
- The modules 'views.blocks' & 'forms.blocks' have been removed.
- These views has been removed :
- bricks.add_portal(), bricks.add_custom_block() & bricks.add_ctypes_2_relation_block().
- button_menu.add().
- fields_config.add().
- generics_views.reload_block() & generics_views.swap_order().
- user_role.add() & user_role.edit().
- setting.reload_block().
- The form classes 'user_role.UserRoleCreateForm' & 'user_role.UserRoleEditForm' have been removed.
- The function 'forms.fields_config._get_fields_enum()' has been removed.
- The templatetags {% import_usersettings_blocks %} & {% do_usersettings_blocks_displayer %} have been removed.
- These template files have been removed : creme_config/custom_fields/*.html & creme_config/blocks_portal.html.
- The variable 'urls.blocks_patterns' has been removed.
* Documents :
- The argument 'count' has been removed in these views of 'quick_forms' : 'abstract_add_doc_from_widget()', 'add_csv_from_widget()'.
- In Bricks, these variable are not injected anymore : FolderDocsBrick (variable "ct_id"), LinkedDocsBrick (variable "ct_doc").
* Persons :
- The function 'models.contact._create_linked_contact()' has been removed.
- In ManagersBrick, the variable "ct" is not injected anymore.
* Activities :
- These modules have been removed : 'views.blocks' & 'forms.blocks'.
- These template files have been removed : 'templatetags/activity_date.html' & 'templatetags/activity_relations_field.html'.
- The method 'AbstractActivity.count_lines_display_block()' has been removed.
- The templatetag library 'activities_tag' has been removed.
- In the view function of views.activity.download_ical(), the argument "ids" has been removed.
- In JavaScript :
- The function 'creme.activities.calendar.filterEvents()' has been removed.
- In 'creme.activities.exportAsICal()' & 'fullCalendar()', the support of implicit "url" has been removed.
* Assistants :
- The JavaScript function 'creme.assistants.validateEntity()' has been removed.
- In all Bricks, the variable "ct_id" is not injected anymore.
* Products :
- The class 'forms.fields.CategorySelector' has been removed.
* Billing :
- These methods of 'models.Base' have been removed : product_lines(), service_lines(), _build_lines(), get_*_lines_total_price_*_of_tax().
- The method 'models.TemplateBase.build()' has been removed.
- The template file 'frags/generic_billing_line_frag.html' has been removed.
- The templatetag library 'latex' has been removed.
- In these Bricks, some variable are not injected anymore : CreditNotesBrick (variable "ct"), PaymentInformationBrick (variable "ct_id"), BillingPaymentInformationBrick (variable "ct_id").
- The 'billing_register' feature has been removed.
- These JavaScript functions have been removed : multiSaveLines(), selectDefaultPayment(), convertAs(), redirect(), reload().
* Commercial :
- These functions in 'views.strategy' have been removed : _reload_matrix(), reload_assets_matrix(), reload_charms_matrix(), reload_assets_charms_matrix().
- These templatetags have been removed :
- {% get_segments_for_category %}, {% widget_segment_category %}, {% widget_asset_score %} & {% widget_charm_score %}.
- In these bricks, the variable "ct_id" is not injected anymore : AssetsBrick, CharmsBrick & ActObjectivesBrick.
- These templates files have been removed : 'templatetags/widget_score.html', 'templatetags/widget_category.html'.
- These JavaScript functions have been removed : postCategory(), increaseObjectiveCounter() & postScore().
* Opportunities :
- In these Bricks, the variable "ct" is not injected anymore : _LinkedStuffBrick (& child classes), TargettingOpportunitiesBrick.
- In _LinkedStuffBrick (& child classes), the class attribute "_model" has been removed.
* Reports :
- The modules have been removed: 'views.blocks' & 'forms.blocks'.
- These functions have been removed : views.report.change_field_order() & views.graph._check_order().
- The "order" parameter has been removed in these views: graph.fetch_graph() & graph.fetch_graph_from_instanceblock().
- These JavaScript functions have been removed : changeOrder(), unlink_report(), setSelected(), doAjaxAction() & openGraphEdition()
* Emails :
- In views:
- The functions 'crudity.reload_sync_blocks()' & 'sending.reload_block_mails()' have been removed.
- In 'crudity.synchronisation()' the template variable "entityemail_ct_id" is not injected anymore.
- These template files have been removed : 'templatetags/_block_synchronization.html' & 'frags/ajax/synchronize.html'.
- In these Bricks, the variable "ct_id" is not injected anymore : EmailRecipientsBrick & MailsBrick.
- These JavaScript functions have been removed: allowExternalImages(), confirmResend() & resend().
* Geolocation :
- These arguments of views have been removed :
- set_address_info() (the argument "address_id").
- get_addresses_from_filter() (the argument "filter_id").
- get_neighbours() (the arguments "address_id" & "filter_id").
- In JavaScript, the fallback to hard-coded URLs have been removed in : AddressesBlock, PersonsNeighborhoodBlock & GoogleMapController.
* Crudity :
- The setting CREME_GET_EMAIL_JOB_USER_ID has been removed.
- These functions in 'views' have been removed: actions.fetch(), actions._fetch(), actions.reload_block(), history.reload().
- In views.history.history(), the context variable "blocks" is not injected anymore.
- The method registry.FetcherInterface.add_fetcher() has been removed.
- These global variables have been removed :
- In 'buttons' : infopath_create_form_button & email_template_create_button.
- In 'fetchers.pop' : pop_fetcher.
- in 'inputs.email' : create_email_input & create_infopath_input.
- These template files has been removed : 'frags/ajax/waiting_actions.html' & 'waiting_actions.html'.
* Polls :
- The templatetag {% print_node_chart %} has been removed.
- In these Bricks, some variables are not injected anymore :
- PollFormLinesBrick ("line_ct_id" & "section_ct_id").
- PollRepliesBrick ("ct_reply").
- _RelatedRepliesBrick & its child classes ("ct_reply").
- The template file 'polls/templatetags/stats_pollreply_chart.html' has been removed.
* Projects :
- The module 'views.utils' has been removed.
- The template files 'projects/frag_task_delay_td.html' has been removed.
* Sms :
- The function 'views.sending.reload_block_messages()' has been removed.
- In RecipientsBrick, the variable "ct_id" is not injected anymore.
Changes caused by Django 1.9 :
- If a 'simple_tag' returns HTML, the result will be escaped if it is not mark_safe()'ed. The best way is to use 'format_html()' & 'format_html_join()' (the result is escaped, so marked as safe).
- In templates, using _() on a classical-format string (with "%s") does not work like before, & should be avoided (because it returns a string with "%%s").
The new way is to use {% trans %}/{% blocktrans %}, & regenerate the related PO files
(notice that in the .po file, 'msgid/msgstr' will use "%%s", but the string returned by 'gettext()' will contain a simple "%s").
- CharFields in forms strip their content by default.
- The import of some models is done later (ie import in function code, not module root).
- If you create your own model field inheriting ForeignKey/OneToOneField, you cannot set a model during migration for 'to' attribute.
- If you import the module 'creme_config.registry', the import should be done after all the app configs are ready (e.g. importing within a view function) in order to avoid errors.
- Django 1.9 does not like '/' at the beginning of URL regex (it says it's useless, but it can be useful in some rare cases).
- The MIMEtype of email attachments is now set.
Changes caused by Django 1.10 :
- The method 'Command.execute()' will crash if all arguments do not receive a value (use 'django.core.management.call_command()' instead).
- The variable 'django.utils.http.PROTOCOL_TO_PORT' has been removed (seems not documented).
Changes caused by Django 1.11 :
- The rendering of form-widgets has changed ; the compatibility with existing 'render()' methods does not always work.
So you should use the new template-based system instead (it's what have been done in Creme -- see below).
- The method 'Widget.format_output()' has been removed (a custom widget template should be used instead).
- The arguments of 'creme_core.forms.bulk.BulkFieldSelectWidget.build_attrs()' have changed to follow the Django 1.11 signature.
- In unit tests, (fake) emails are not sent when the recipient is empty anymore.
Most of libraries have been upgraded :
- 'bleach' 1.4.X => 2.1.X.
- 'xlrd' : 0.9.X => 1.1.X
- 'xlwt' 1.0.X => 1.3.X.
- 'Pillow' : 3.4.X => 5.X.
- 'pygraphviz' : 1.1.X => 1.3.X.
In settings :
- 'MIDDLEWARE_CLASSES' has been removed & replaced by 'MIDDLEWARE'.
- The default settings 'LOGIN_REDIRECT_URL' & 'LOGIN_URL' use now named URLs.
- The setting 'LOGOUT_URL' has been removed, because Django (1.10) removed it too (it was unused anyway).
- The settings which were tuples are now lists (like in Django 1.9 global_settings), excepted 'COPY_MEDIA_FILETYPES' which is now a 'set'.
- The middleware "django.middleware.security.SecurityMiddleware" has been added in the default configuration ; it probably won't be a problem excepted on very specific install.
- Beware 'formtools' has been added in 'INSTALLED_DJANGO_APPS'.
- The logging configuration have slightly changed (formats of messages are different).
Using a method 'register_setting_key()' in a class inheriting CremeAppConfig is deprecated ; rename it 'register_setting_keys()'.
In views of all apps, the content-type of the response have been cleaned ; it probably does not break anything (or only unit tests).
- In views which return JSON data with "text/javascript" as content_type, the content_type is now "application/json" (many of these views use creme_core.utils.jsonify()).
- Lots of responses, with "text/javascript" as content_type, & which return a empty/string/HTML-fragment content, have now "text/html' as content_type.
It probably only break unit tests.
In 'creme_core.models' :
- The class attribute 'CremeModel._delete_files' has been removed ; override the methods _delete_stored_file()/_delete_stored_files() to customise the behaviour.
- The field 'CremeAbstractEntity.is_actived' has been removed (so it's removed from 'CremeEntity' & 'Relation').
- The fields "block_id" of the following models (in 'bricks') have been renamed to "brick_id" :
BlockDetailviewLocation, BlockPortalLocation, BlockMypageLocation, RelationBlockItem, InstanceBlockConfigItem, BlockState.
- In the method 'BlockDetailviewLocation.id_is_4_model()', the argument "block_id" is renamed "brick_id".
In 'creme_core.views' :
- The view 'search.search()' injects now a variable "bricks" instead of "blocks" ;
the related template 'creme_core/search_results.html' has changed to use "bricks".
- In 'list_view_export.dl_listview()' (backported to 1.7.3) :
- The GET argument "hfilter" is now mandatory (last list-view state is no longer used as fallback).
- The attribute "extra_q" of the list-view state is not read any more ; the GET argument "extra_q" is used instead.
- The view 'batch_process.batch_process()' does not use the GET argument "list_url" anymore ; it uses the GET argument "efilter" instead.
In 'creme_core.forms' :
- The method 'mass_import.ImportForm.append_error()' only takes the argument "err_msg" now (there were 3 arguments).
- The behaviour of the merge form with ManyToManyFields has been fixed ; the many to many data are changed during the save(), & not during the clean() anymore.
- The behaviour of the bulk/inner edition with ManyToManyFields has been fixed ; the many to many data are changed during the save(), & not during the clean() anymore.
- The rendering of widgets have been heavily reworked to use templates :
- The methods 'format_output()' have been removed in the following class of 'widgets' : DatePeriodWidget, DurationWidget, OptionalWidget, DateRangeWidget.
- In 'widgets.DateRangeWidget.render()', passing an attributes "render_as" not in {'table', 'ul'} will raise an exception ("template not found"). You can define your own type of render by creating a template file.
- These methods of 'widgets.UnorderedMultipleChoiceWidget' have been removed: _render_header_filter(), _render_header(), _render_body(), _render_counter(), _render_viewless(), _render_footer().
- If you inherit 'widgets.EnhancedSelectOptions' :
- It should be before the parent Widget class in the parents list.
- These methods have been removed : render_enchanced_option(), is_choice_selected(), render_enhanced_choice().
- The method 'header_filter.EntityCellsWidget._build_render_context()' has been removed.
- In 'mass_import.ExtractorWidget' :
- The base class changed from 'SelectMultiple' to the new class 'BaseExtractorWidget' (which inherits directly Widget).
- The method '_render_select()' has been removed.
- In 'mass_import.EntityExtractorWidget', the methods '_render_line()' & '_render_column_select()' have been removed.
- The attribute 'filtertype' of 'widgets.UnorderedMultipleChoiceWidget' now raises a ValueError if the given value was invalid (so a breaking indicates an existing bug).
The constructors of the following classes take an additional argument "model" : EntityCellActions, EntityCellFunctionField, EntityCellRelation, EntityCellVolatile.
The arguments of 'creme_core.utils.html.filter_img_src()' have change (to follow the API changes in 'bleach').
In 'creme_core.gui' :
- The different registries from sub-modules are not imported in the package anymore.
- In the method 'buttons.ButtonsRegistry.register()', when an ID is duplicated, an exception is raised now (there was only a log message).
- In 'bricks' :
- The method 'Brick.get_template_context()' does not inject "base_url" in the context anymore.
- About the method 'Brick._build_template_context()' :
- It does not inject "block_name" in the context anymore (use "brick_id" instead).
- These arguments have been renamed :
- 'block_name' became 'brick_id'.
- 'block_context' became 'brick_context'.
- In 'SpecificRelationsBrick', the context variable "colspan" is not injected anymore.
- About the class 'InstanceBlockConfigItem' :
- In the method 'generate_id()', the argument "block_class" is renamed "brick_class".
- In the methods 'id_is_specific()' & 'get_base_id()', the (only) argument has been renamed 'brick_id'.
The templatetag {% verbose_modifications %} (from 'creme_core_tags') has been renamed/moved as {% history_modifications %} (in 'creme_history').
In the templates of 'creme_core' :
- In the template file 'detailview.html' (& so in 'generics/view_entity.html'):
- The {% block %} "button_tab" & "extra_menu_buttons" have been removed (use {% block instance_buttons %} instead).
- The CSS class "is_deleted" is not set anymore (it's done in 'generics/view_entity.html').
- Some template files have been renamed :
- 'batch_process.html' has moved to 'forms/batch-process.html'.
- 'entity_filter_form.html' has moved to 'forms/entity-filter.html'.
- 'header_filter_form.html' has moved to 'forms/header-filter.html'.
- 'merge.html' has moved to 'forms/merge.html'.
- The template 'creme_core/entity_cells_widget.html' has been removed (replaced by 'creme_core/forms/widgets/entity-cells.html').
In the following apps, the buttons template files have been moved (from 'templatetags/' to 'buttons/') & renamed :
activities, billing, commercial, emails, opportunities, persons, tickets, vcfs.
Some unused images have been removed.
Lots of useless CSS rules have been removed.
In JavaScript :
- The functions 'creme.utils.blocks_deps()' & 'creme.blocks.bindEvents()' have been removed.
- The function 'creme.forms.toImportField()' takes now a second argument (the query to get the element to hide).
- The option "compatible" of 'creme.dialog.Dialog' has been removed.
In 'creme_core.tests' :
- The class attribute '_CremeTestCase.clean_files_in_teardown' has been removed ; you should remove it from your own TestCase classes because it is not used anymore.
- These fields of test models have been renamed :
- 'FakeDocument.folder' is now "linked_folder".
- 'FakeInvoiceLine.invoice' is now "linked_invoice".
Apps :
* Creme_config :
- The validation of Users passwords is now stronger by default in the forms ; it could break some unit tests, or external programs which create users.
- The URL '/creme_config/my_settings' has changed to '/creme_config/my_settings/portal'(internally you should use its name "creme_config__user_settings" anyway).
* Documents :
- The field 'models.AbstractDocument.folder' has been renamed "linked_folder".
- The related name of 'AbstractFolder.parent_folder' has been changed from "parent_folder_set" to "children".
* Activities :
- In 'forms.mass_import' :
- The classes 'ParticipantsExtractorWidget' & 'SubjectsExtractorWidget' inherit now the new class 'BaseExtractorWidget'.
- In the method 'SubjectsExtractorWidget.value_from_datadict()', the key "column_index" has been replaced by "selected_column".
- In 'ParticipantsExtractorWidget' :
- In the POSTed values '{name}_colselect' became '{name}_pattern_colselect'.
- In the return value of the method 'value_from_datadict()' "column_index" became "pattern_column_index".
- The JavaScript function 'creme.activities.calendar.fullCalendar()' has been modified to pass calendar IDs as GET arguments.
* Assistants :
- The argument "user" of 'bricks._AssistantsBrick._populate_related_real_entities()' has been removed.
* Products:
- The class 'forms.base._BaseCreateForm' has been removed ; the classes 'forms.product.ProductCreateForm' & 'forms.service.ServiceCreateForm' have been adapted.
- The class 'forms.mass_importCategoriesExtractorWidget' now inherits 'BaseExtractorWidget'.
* Billing :
- In JavaScript :
- The function 'creme.billing.updateBlockTotals()' has been renamed "updateBrickTotals()".
- In tne function 'creme.billing.markDelete()' :
- The second (on 3) argument "ct_id" has been removed.
- The CSS class "block_header_line_dark" is not set anymore.
* Reports :
- The field 'models.AbstractReportGraph.report' has been renamed "linked_report".
- The field 'models.FakeReportsDocument.folder' has been renamed "linked_folder".
- The method 'forms.report.ReportHandsWidget._build_render_context()' has been removed.
- The template 'reports_hands_widget.html' has been removed (replaced by 'forms/widgets/report-hands.html').
* Geolocation :
- The templatetag library 'geolocation' has been renamed 'geolocation_tags'.
- The templatetag 'format_distance' has been renamed 'geolocation_distance'.
- The CSS rules "block-geoaddress-*" have been renamed "brick-geoaddress-*" in HTML/CSS/JavaScript.
- The following JavaScript classes have been renamed :
- 'creme.geolocation.PersonsBlock' became 'creme.geolocation.PersonsBrick'.
- 'creme.geolocation.AddressesBlock' became 'creme.geolocation.AddressesBrick'.
- 'creme.geolocation.PersonsNeighborhoodBlock' became 'creme.geolocation.PersonsNeighborhoodBrick'.
* Emails :
- The following models fields are now 'blank=False' (blank was useless because these fields are not editable):
_Email.reads, _Email.sending_date, _Email.reception_date, AbstractEntityEmail.identifier, EmailSending.signature.
* Crudity :
- The field 'models.WaitingAction.data' has been renamed "raw_data".
- The method 'models.WaitingAction.set_data()' now assigns the data & returns nothing.
- The method 'registry.CRUDityRegistry.get_backend()' raises now 'CRUDityRegistry.RegistrationError' exceptions (it raised 'creme_core.registry.NotRegistered').
- In 'backends.models.CrudityBackend' :
- The methods 'get_rendered_buttons()' & 'add_buttons()' have been removed.
- The attribute 'buttons' has been removed.
- The class attribute 'blocks' has been replaced by 'brick_classes' (which has a different default value).
- In 'inputs.base.CrudityInput' :
- The method 'register_buttons()' has been removed.
- The attribute '_buttons' has been removed.
- The attribute 'backends' has been renamed '_backends'.
- In 'bricks.WaitingActionsBrick' & 'bricks.CrudityHistoryBrick', the variable "title" is not injected in the context anymore.
- The classes in 'buttons' have been removed (InfopathCreateFormButton, EmailTemplateCreateButton).
* Events :
- In the dictionary returned by 'AbstractEvent.get_stats()', the id "invations_count" has been renamed "invitations_count".
* Polls :
- These templatetags have been renamed :
- print_line_condition -> poll_line_condition
- print_node_number -> poll_node_number
- print_node_css -> poll_node_css
* Projects :
- The field 'models.AbstractProjectTask.project' has been renamed "linked_project".

Internal breaking changes :
---------------------------
(they should not cause problem if you have not deeply modified the source code of Creme)

The method 'CremeCoreConfig.hook_widget_render()' has been removed.
In 'creme_core.constants' SETTING_BLOCK_DEFAULT_STATE_IS_OPEN & SETTING_BLOCK_DEFAULT_STATE_SHOW_EMPTY_FIELDS are now deprecated
(use SETTING_BRICK_DEFAULT_STATE_IS_OPEN & SETTING_BRICK_DEFAULT_STATE_SHOW_EMPTY_FIELDS instead).
The middleware classes (in 'creme_core.middleware' & 'mediagenerator.middleware') now inherit 'django.utils.deprecation.MiddlewareMixin'.
In 'creme_core.models' :
- The fields 'bricks.RelationBlockItem.json_cells_map' & 'CustomBlockConfigItem.json_cells' cannot be 'null' anymore (a default value has been added).
- The attribute 'bricks.InstanceBlockConfigItem._block' has been renamed to "_brick".
In 'creme_core.views' :
- The method 'search.FoundEntitiesBrick.parse_block_id()' is replaced by 'parse_brick_id()'.
- The method 'creme_property.TaggedEntitiesBrick.parse_block_id()' is replaced by 'parse_brick_id()'.
In 'creme_core.forms.widgets' :
- These methods of 'SelectorList' have been removed: _render_action(), _render_actions().
- The method '_render_inputs()' of 'ChainedInput' & 'PolymorphicInput' have been removed.
- The class 'CremeRadioFieldRenderer' has been removed (because 'django.forms.widgets.RadioFieldRenderer' has been removed).
The attribute 'creme_core.buttons.ButtonsRegistry._buttons' has been renamed to "_button_classes".
The JavaScript widget 'creme.widget.DateRange' has been entirely reworked.
Apps :
* Creme_config :
- The variable 'templatetags.creme_config_tags._USER_SETTINGS_BLOCK' has been removed.
* Activities :
- The function 'views.calendar._get_one_activity_per_calendar()' is now a generator.
* Reports :
- The global variable 'views.report._order_direction' has been removed.
- The tag 'templatetags.reports_tags.report_chart_json()' does not take the context any more.
- In 'forms.report', the constructors of the following classes take an additional argument "model" :
_EntityCellRelated, _EntityCellAggregate, _EntityCellCustomAggregate.