silva.core.references 3.0.4
Define a reference engine usable by Silva content
License: BSD
Keywords: silva cms references zope

=====================
silva.core.references
=====================

Introduction
============

``silva.core.references`` is a core `Silva`_ extension that defines
directed references between two Silva content: a source and
target. With the help of a central catalog, you have the possibility
to query the references in both direction: who is the target if I am
the source, and who is the source if I am the target.

References are tagged with different names, and can be found by
searching on one of those names.

Unless you use weak references, you can't remove an content which is a
target of a reference, you will get an error. If you used a weak
reference, the source will be removed.

This extension provides you with a set of fields and widgets that can
be used in forms (`zeam.form`_ and Formulator) in SMI.

Usage
=====

This extension is used to manage links and relations in Silva
Document, Silva Ghost and Silva Link for instance.

Code repository
===============

The code for this extension can be found in Git at:
https://github.com/silvacms/silva.core.references

.. _zeam.form: http://pypi.python.org/pypi/zeam.form.base
.. _Silva: http://silvacms.org/

Changes
=======

3.0.4 (2013/12/18)
------------------

- Display the list of broken references in SMI as well.

- Improve a little the performances.

- Fix the reference lookup widget that could display an invalid edit
  link to the original content in complicated virtual host setup.

- Update icons.

3.0.3 (2013/08/26)
------------------

- Fix bugs on service template.

- Fix scope of the CSS defined for the reference widget.

3.0.2 (2013/05/24)
------------------

- Optimize path computation helpers.

- Update widget's javascript to be compatible with jQuery 1.9.

3.0.1 (2013/03/06)
------------------

- Add a widget for ``zeam.form`` and multiple references.

- Update Formulator to match new Silva XML import / export feature.

- Introduce ``IReferable`` interface that must implemented for all
  content that can be the target of a reference. This fixes problems
  where cleanup wasn't called if the target wasn't a Silva content.

- ``ReferenceSet`` object have been improved performance wise.

3.0 (2012/12/11)
----------------

- Small bug fixes when the widget is not used in the SMI.

3.0c1 (2012/09/24)
------------------

- Add a new reference type, ``DeleteSourceReferenceValue``, that
  automatically delete the source of the reference of the target is
  removed (so is the reference).

- Improve reference selection widget.

- Improve tests.

- Fix bugs (non-required values).

3.0b1 (2011/11/10)
------------------

- Add a Formulator field for relations, that are used in Code Sources.

- Fix some Aquisition bug edge-case.

- Improve widget popup to work with ``silva.ui``, and have default SMI
  feature (such as preview).


2.3.3 (2010-02-07)
------------------

- Add a refresh functionality to the JS reference selection popup.

- Add the possibility to add new content from the JS reference selection
  popup.

- Fix some bugs on content suppression (and add test for this case).

- Fix various small issues.

2.3.2 (2010-12-20)
------------------

- Add a clear fonctionality to the JS reference selection popup.

- If nothing is selected in the JS reference popup, no link is generated
  in the field. An edit link in the field have been added as well.

2.3.1 (2010-10-18)
------------------

- Improve references graphs representation.

- Add a ``ReferenceSet``.

- Fix some bugs in case of duplication of broken references.


2.3 (2010-07-16)
----------------

- First official release.