Dexterity I: “Through The Web”

In this part you will:

  • Create the new content type talk

Topics covered:

  • content types
  • archetypes and dexterity
  • fields
  • widgets

What is a content type?

A content type is a variety of object that can store information and is editable by users. We have different content types to reflect the different kinds of information about which we need to collect and display information. Pages, folders, events, news items, files (binary) and images are all content types.

It is common in developing a web site that you’ll need customized versions of common content types, or perhaps even entirely new types.

Remember the requirements for our project? We wanted to be able to solicit and edit conference talks. We could use the page content type for that purpose. But there are bits of information we need to make sure we collect about a talk and we wouldn’t be sure to get that information if we just asked potential presenters to create a page. Also, we’ll want to be able to display talks featuring that special information, and we’ll want to be able to show collections of talks. A custom content type will be ideal.

The makings of a Plone content type

Every Plone content type has the following parts:

Esquema
A definition of fields that comprise a content type; properties of an object.
FTI
The “Factory Type Information” configures the content type in Plone, assigns it a name, an icon, additional features and possible views to it.
Views
A view is a representation of the object and the content of its fields that may be rendered in response to a request. You may have one or more views for an object. Some may be visual — intended for display as web pages — others may be intended to satisfy AJAX requests and be in formats like JSON or XML.

Dexterity y Arquetipos - Una comparacion

There are two content frameworks in Plone

  • Dexterity: nuevo y el que vendra por defecto

  • Arquetipos: los tipos de contenidos viejos, intentados y probados

  • Arquetipos: extenso sin embargo con complementos

  • Plone 4.x: Archetypes is the default, with Dexterity available
  • Plone 5.x: Dexterity is the default with Archetypes available
  • For both, add and edit forms are created automatically from a schema

¿Cuales son las diferencias?

  • Dexterity: New, faster, modular, no dark magic for getters and setters
  • Archetype had magic setter/getter - use talk.getAudience() for the field audience
  • Dexterity: fields are attributes: talk.audience instead of talk.getAudience()

TTW:

  • Dexterity has a good TTW story.
  • Archetypes has no TTW story.

  • Modelado UML ArchGenXML para arquetipos, agx para Dexterity

Acercamiento para desarrolladores:

  • Schema in Dexterity: TTW, XML, Python. Interface = schema, often no class needed
  • Schema in Archetypes: Schema only in Python
  • Dexterity: Easy permissions per field, easy custom forms.
  • Archetypes: Permissions per field hard, custom forms even harder.
  • If you have to program for old sites you need to know Archetypes!
  • If starting fresh, go with Dexterity.

Extendiendo:

  • Dexterity has Behaviors: easily extendable. Just activate a behavior TTW and your content type is e.g. translatable (plone.app.multilingual).
  • Archetypes has archetypes.schemaextender. Powerful but not as flexible.

We have only used Dexterity for the last few years. We teach Dexterity and not Archetypes because it’s more accessible to beginners, has a great TTW story and is the future.

Vistas:

  • Both Dexterity and Archetypes have a default view for content types.
  • Browser Views provide custom views.

  • A través de la Web (en el futuro)

  • Formularios de visualización

Modificando tipos existentes

  • Ir a panel de control http://localhost:8080/Plone/@@dexterity-types

  • Inspecciona algunos de los tipos de contenido existentes por defecto

  • Seleccione el tipo de elemento Noticias y agregar un nuevo campo Noticias caliente de tipo Sí ​​/ No

  • En otra pestaña agregar un tipo de contenido Noticia y entonces se ve el nuevo campo.

  • Go back to the schema-editor and click on Edit XML Field Model.

  • Note que el único campo en el esquema XML de la Noticia es el que acaba de agregar. Todos los demás son proporcionados por los comportamientos.

  • Edit the form-widget-type so it says:

    <form:widget type="z3c.form.browser.checkbox.SingleCheckBoxFieldWidget"/>

  • Edit the News Item again. The widget changed from a radio field to a checkbox.

  • El nuevo campo Noticias caliente no se visualiza cuando se representa la Noticia. Nosotros nos ocuparemos de esto más adelante.

Ver también

http://docs.plone.org/external/plone.app.contenttypes/docs/README.html#extending-the-types

Creating content types TTW

In this step we will create a content type called Talk and try it out. When it’s ready we will move the code from the web to the file system and into our own add-on. Later we will extend that type, add behaviors and a viewlet for Talks.

  • Agregar un nuevo tipo “Talk” y algunos campos para el:

    • Agregue el campo “Type of talk”, de tipo “Choice”. Agregar opciones talk, keynote, training

    • Agregar Campo “Details”, de tipo “Rich Text” con un tamaño máximo de 2000

    • Agregar Campo “Audience”, de tipo “Multiple Choice”. Agregar opciones: beginner, advanced, pro

    • Check the behaviors that are enabled: Dublin Core metadata, Name from title. Do we need them all?
  • Test the content type

  • Regrese al panel de control http://localhost:8080/Plone/@@dexterity-types

  • Extiende el nuevo tipo

    • “Speaker”, type: “Text line”
    • “Email”, type: “Text line”
    • “Image”, type: “Image”, not required
    • “Speaker Biography”, type: “Rich Text”

  • Probar otra vez

Aquí está el código completo de esquema XML creado por nuestras acciones.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
<model xmlns:security="http://namespaces.plone.org/supermodel/security" xmlns:marshal="http://namespaces.plone.org/supermodel/marshal" xmlns:form="http://namespaces.plone.org/supermodel/form" xmlns="http://namespaces.plone.org/supermodel/schema">
  <schema>
    <field name="type_of_talk" type="zope.schema.Choice">
      <description/>
      <title>Type of talk</title>
      <values>
        <element>Talk</element>
        <element>Training</element>
        <element>Keynote</element>
      </values>
    </field>
    <field name="details" type="plone.app.textfield.RichText">
      <description>Add a short description of the talk (max. 2000 characters)</description>
      <max_length>2000</max_length>
      <title>Details</title>
    </field>
    <field name="audience" type="zope.schema.Set">
      <description/>
      <title>Audience</title>
      <value_type type="zope.schema.Choice">
        <values>
          <element>Beginner</element>
          <element>Advanced</element>
          <element>Professionals</element>
        </values>
      </value_type>
    </field>
    <field name="speaker" type="zope.schema.TextLine">
      <description>Name (or names) of the speaker</description>
      <title>Speaker</title>
    </field>
    <field name="email" type="zope.schema.TextLine">
      <description>Adress of the speaker</description>
      <title>Email</title>
    </field>
    <field name="image" type="plone.namedfile.field.NamedBlobImage">
      <description/>
      <required>False</required>
      <title>Image</title>
    </field>
    <field name="speaker_biography" type="plone.app.textfield.RichText">
      <description/>
      <max_length>1000</max_length>
      <required>False</required>
      <title>Speaker Biography</title>
    </field>
  </schema>
</model>

Moving content types into code

It’s awesome that we can do so much through the web. But it’s also a dead end if we want to reuse this content type in other sites.

Also, for professional development, we want to be able to use version control for our work, and we’ll want to be able to add the kind of business logic that will require programming.

So, we’ll ultimately want to move our new content type into a Python package. We’re missing some skills to do that, and we’ll cover those in the next couple of chapters.

Ver también

Exercises

Exercise 1

Modify Documents to allow uploading an image as decoration (like News Items do).

Solution

The images are displayed above the title.

Exercise 2

Create a new content type called Speaker and export the schema to a XML File. It should contain the following fields:

  • Title
  • Email
  • Homepage (optional)
  • Biography (optional)
  • Company (optional)
  • Twitter Name (optional)
  • IRC Name (optional)
  • Image (optional)

Do not use the IDublinCore or the IBasic behavior since a speaker should not have a description.

We could use this content type later to convert speakers into Plone users. We could then link them to their talks.

Solution

The schema should look like this:

<model xmlns:security="http://namespaces.plone.org/supermodel/security"
       xmlns:marshal="http://namespaces.plone.org/supermodel/marshal"
       xmlns:form="http://namespaces.plone.org/supermodel/form"
       xmlns="http://namespaces.plone.org/supermodel/schema">
  <schema>
    <field name="title" type="zope.schema.TextLine">
      <title>Name</title>
    </field>
    <field name="email" type="zope.schema.TextLine">
      <title>Email</title>
    </field>
    <field name="homepage" type="zope.schema.TextLine">
      <required>False</required>
      <title>Homepage</title>
    </field>
    <field name="biography" type="plone.app.textfield.RichText">
      <required>False</required>
      <title>Biography</title>
    </field>
    <field name="company" type="zope.schema.TextLine">
      <required>False</required>
      <title>Company</title>
    </field>
    <field name="twitter_name" type="zope.schema.TextLine">
      <required>False</required>
      <title>Twitter-Name</title>
    </field>
    <field name="irc_name" type="zope.schema.TextLine">
      <required>False</required>
      <title>IRC-Name</title>
    </field>
    <field name="image" type="plone.namedfile.field.NamedBlobImage">
      <required>False</required>
      <title>Image</title>
    </field>
  </schema>
</model>

Ver también