pyams/pyams_user_guide: comparison src/source/howto-paragraph.rst

equal deleted inserted replaced

-:8e05d726d4ad
+:9783741e866d
 ========================================================
 Adding the following marker interface, we add new behavior to the Paragraph `ContactPhoneParagraph` .
-Paragraph in the ZMI
+Paragraph advanced
-""""""""""""""""""""
+""""""""""""""""""
-1) Inner form
+You can attach Associated files, links or illustration and manage them directly through the rubric `Links and Attachments`.
--------------
-.. code-block:: python
-@adapter_config(context=(IContactPhoneParagraph, IPyAMSLayer), provides=IParagraphInnerEditor)
-@implementer(IInnerForm, IPropertiesEditForm, IAssociationParentForm)
-class ContactPhoneParagraphInnerEditForm(ContactPhoneParagraphPropertiesEditForm):
-"""Contact paragraph inner edit form"""
-legend = None
-ajax_handler = 'inner-properties.json'
-Marker interfaces:
-:py:class:`IPropertiesEditForm`
-:py:class:`IAssociationParentForm`
-.. image:: _static/associations_form.png
-2) Inside a dedicated menu
---------------------------
 .. image:: _static/select_links_n_attachment.png
+1) Paragraph with Links and Attachements
+----------------------------------------
+To "activate" this features the paragrath object must to implement specific interface
 .. code-block:: python
 @implementer(IContactPhoneParagraph, IIllustrationTarget,ILinkContainerTarget,IExtFileContainerTarget))
 class ContactPhoneParagraph(BaseParagraph):
 """Contact paragraph"""
 ...
-Marker interfaces:
+These interfaces will allow to link other data to the paragraph.
+**Marker interfaces:**
 +--------------------------------+
 |:py:class:`IIllustrationTarget` |
 +===================+============+
 |                   |            |
 |                +-------------------+
 |                | Add audio file    |
 +----------------+-------------------+
-ZMI overview:
+**ZMI overview:**
 .. image:: _static/select_add_links.png
+2) Add link and association form
+--------------------------------
+You can add form to manage links and attachments directly in paragraph form to do that your form must implement
+``IPropertiesEditForm`` and/or  ``IAssociationParentForm``
+.. code-block:: python
+@adapter_config(context=(IContactPhoneParagraph, IPyAMSLayer), provides=IParagraphInnerEditor)
+@implementer(IInnerForm, IPropertiesEditForm, IAssociationParentForm)
+class ContactPhoneParagraphInnerEditForm(ContactPhoneParagraphPropertiesEditForm):
+"""Contact paragraph inner edit form"""
+legend = None
+ajax_handler = 'inner-properties.json'
+**Marker interfaces:**
++-----------------------------------+
+|:py:class:`IPropertiesEditForm`    |
++=========+=========================+
+|         | Add Illustration form   |
++---------+-------------------------+
++-----------------------------------+
+|:py:class:`IAssociationParentForm` |
++===========+=======================+
+|           | Add Association form  |
++-----------+-----------------------+
+.. image:: _static/associations_form.png

branch	doc-dc
changeset 97	9783741e866d
parent 87	a5c0ec15b437
child 104	942151432421