• Introducción

  last modified March 22, 2008 by r0ver

Note: Return to reference manual view.

Manual de usuario Plone para administradores y creadores de contenido.

1. Resumen conceptual

Introducción de Plone como sistema de gestión de contenidos.

¿ Qué es Plone ?

Plone es un sistema de gestión de contenidos (del inglés, CMS) que puede emplearse para construir un sitio web. Empleando Plone, personas sin conocimientos de programación o sin ser expertos pueden contribuir al contenido de un sitio web.

Plone funciona vía web, por lo tanto no necesita instalar ningún software especial en la computadora del cliente. La palabra contenido es usada en un sentido general porque se pueden publicar distintos tipos de información, incluyendo:

 

Un sitio Plone contiene diferentes tipos de contenido, incluyendo textos, fotos e imágenes. Estos pueden ser almacenado en diferntes modos: documentos, item de noticias, eventos, videos, archivos de audio y cualquier tipo que pueda ser subido o creado en un sitio web. El contenido tambien puede subirse desde una computadora local. Además Plone permite crear carpetas para organizar el contenido y crear una estructura de navegación.

Las Mariposas

Si se deseara agregar contenido sobre mariposas, por ejemplo, se puede crear una carpeta llamada "Mariposa" y luego agrerar texto a una página dentro de la carpeta:
 

También se pueden agregar imágenes a la carpeta:

Dentro de una carpeta se pueden agregar muchos contenidos de distintos tipos, incluyendo subcarpetas. Luego de agregar algunos reportes y videos sobre mariposas, el contenido debería estar organizado como se muestra a continuación, con dos sub-carpetas dentro de la carpeta Mariposas:

 

¿ Qué ocurre destrás de las bambalinas ?

Es probable que el lector se pregunte como funciona todo. Un sitio Plone típico existe como una instancia  de Plone instalada en un servidor web. El servidor web puede estar en cualquier sitio, usualmente en una compañía de hosting con una "pila" de computadoras dedicadas a realizar la tarea:

El diagrama muestra los cables que conectan los servidores individuales a internet. El sitio Plone es solo un programa y una base de datos instalados en uno de las servidores. Cuando se escribe texto o se hace click, la computadora del usuario envía y recibe datos por medios de la red para interactuar con Plone. 

Simplificando, el siguiente diagrama muestra como la computadora del usuario interactua con Plone:

Usando un navegador web, por ejemplo Firefox, Safari, Internet Explorer, se ven y editan las páginas de un sitio web hecho con Plone. Los cambios son almacenados por Plone en su sistema de base de datos.

Por ejemplo, si el sitio de Mariposas está ubicado en el sitio misitio.com. Si se escribe www.misitio.com  en el navegador, luego de presionar intro, la siguiente secencia de eventos es llevada a cabo entre el navegador y el servidor de www.misitio.com:

Luego el software Plone responde:

Plone lee si base de datos para buscar la información almacenada en misitio.com. Luego devuelve la página a la computadora del usuario en un código llamado HTML. HTML es un lenguaje de computadora que describe con luce una página web, incluye texto, gráficos, tipos de letras, el color del fondo, etc. En internet existen muchos sitios donde se puede aprender HTML detalladamente pero una de las ventajas de Plone es que no es necesario aprender (demasiado) sobre HTML. Esa es una de las razones por la que Plone y las otros softwares similares permiten al usuario concentrarse solamente en el contenido, es decir, el texto y los gráficos de las mariposas en vez de aprender un nuevo lenguaje de computadoras.

Volviendo a la interacción entre la computadora del usuario y el servidor. El navegador web muestra o traduce el HTML en la página que el usuario ve en su navegador: 

Del mismo modo que se ve la página de mariposas, se puede editar o modificar. En cualquier momento se puede subir fotos, documentos, etc: 

Luego de que se edita y se hace click en "guardar cambios", la nueva versión de la página web se mostrará a cualquiera que visite el sitio:

 

2. Diseño visual de los sitios web Plone

Plone permite a diseñadores y administradores crear diseños únicos para sus sitios. En esta sección se hace un breve recorrido por el esuqema de Plone y algunos ejemplos de diseño.  

Como luce un sitio web hecho con Plone ? Hace varios años existe un diseño consistente para la apariencia por defecto de Plone. El diseño por defecto, generalmente tiene la forma:

plone-default-design-areas.png

Aunque un sitio Plone puede tener un diseño radicalmente distinto el usuario deberia identificar los elementos comunes, como por ejemplo el panel de navegación o el menú. En el diseño por defecto, el menú de navegación está a la izquierda y usualmente muestra una lista de carpetas. También puede haber pestañas sobre el contenido.

Es posible distinguie entre el diseño de un sitio web y su funcionalidad. En vistas de terminar el trabajo hay que concentrarse en la funcionalidad y sin prestar mucha atención al diseño. Una fortaleza del sistema de contenidos Plone es el soporte de rediseño radical sin afectar al contenido ni funcionalidad.

El menú de navegación puede moverse de izquierda a derecha y funcionará del mismo modo. Las áreas izquierdas, principal, derechas como se muestran en la figura pueden intercambiarse de lugar y el sitio seguirá siendo Plone.

Dada la flexibilidad en la organización de los elementos de contenido, se usará el diseño por defecto que trae Plone:

Estos términos pueden requerir cierta adaptación para diseños especiales. Seguramente se usarán términos variados para describir el diseño real del sitio, como por ejemplo slots o paneles izquierdo y derecho para las columnas de los laterales. Portlets o viewlets para las áreas o "cajas", entre otros.

A modo de ejemplo, se seleccionará tres sitios para comparar tomados de la lista de sitios Plone

 

En la figura se muestra el sitio de Akamai, un proveedor de herramientas webs. El encabezado posee un simple menú con enlaces que lista horizontalemente a las cinco secciones principales de contenido. A la derecha, el encabezado posee otro menú horizontal y el diálogo de búsqueda. En el pie del encabezado se muestra la opción para autenticarse o entrar al sitio, opción empleada por administradores del mismo. Debajo del encabezado y a la izquierda, se muestra una imágen que puede cambiar de acuerdo a la sección. Debajo de la imágen, al centro se muestra un texto y a la derecha una serie de portlets. El pie de la página posee un menú horizontal, repitiendo las opciones del encabezado. Por último, a la derecha hay una opción con opciones de zoom.


En la figura se muestra el sitio de la revista Discover. El área de encabezado contiene un extenso menú horizontal, el menú horizontal. En la esquina superior derecha se hay otro menu y el cuadro de diálogo de búsqueda. Este sitio es posee un gran número de portlets que cubren diferentes temas. Los portlets están agrupados en tres columnas, izquierda, centro y derecha. En la parte superior de la columna del centro hay un video y en diferentes partes del sitio abundan cuadros interactivos. El piede la página contiene información básica sobre la identificación y un enlace a "acerca de". En sitios complejos como lo es la revista Discover, los administradores de contenido se autentican mediante pantallas especiales. Además hacen uso extensivo de mecanismos de automatización como feeds - Plone está construido sobre Zope, un sistema sofisticado de almacenamiento y Python, un excelente lenguaje de programación que facilita mucho el "cableado" inteligente de texto y gráficos en un sitio web.

 

El último ejemplo de los sitios es el Colegio de Negocios Smeal de la Universidad Estatal de Penn. El encavezado contiene un logo, un menú horizontal para las áreas principales y un cuadro de búsqueda a la derecha. El sitio posee un menú a la izquierda, elemento compun en un sitio Plone. Un área gráfica extensa contiene una animación. La columna izquierda contiene otro punto de atención en un gráfico. El área de contenido está dividida en tres columnas que se ubican sobre el pie de página que posee información de identificación del sitio.

Para concluir, ¿ como luce un sitio hecho en Plone ?, de fábrica luce como se mostro en las primeras figuras de esta página, con encabezado, menu, columnas y pie de página. Los tres sitios mostrados son ejemplos de como los diseñadores pueden combinar distintas áreas, menú horizontales y verticales, portlets, texto contextual. La maquinaria base es Plone, sobre Zope y Python, pero el diseño llamado "tema" o skin, puede tener la forma que defina el diseñador.


3. Cuentas y roles de usuarios en Plone 

Elementos básicos de usar una cuenta de un sitio web Plone, distinción entre un usuario anónimo y autenticado. Descripción de roles.

Los sitios construidos sobre Plone son muy diversos: sitios personales, sitios de comunidades, organizaciones o negocios, etc. Todos ellos pueden tener cientos de usuarios. Cada persona que agrega contenido a un sitio Plone debe tener su propia cuenta de usuario. Una cuenta de usuario está compuesta de un nombre de usuario y una contraseña. Algunos sitios Plone permiten que sus visitantes creen sus propias cuentas  mediante la opción unirse y un formulario que requiere información elemental. Otros sitios poseen cuentas que son creadas por administradores que suelen recibir los detalles por medio de mails.

Una vez creada la cuenta, un usuario Plone permite a una persona acceder al área de administración de contenido ingresando su nombre y contraseña. Las contraseñas son sensibles a mayúsculas. Esto siginifa que hay que prestar atención al momento de escribir la contraseña porque no es lo mismo escribir una letra en mayuscula o minuscula. Por ejemplo, si la contraseña es xcFGt6v hay que escribirla exactamente de ese modo, caso contrario no se podra lograr el acceso. En general se recomienda emplear contraseñas que tengan distintos caracteres antes que aquellos que tienen letras que se repiten como puede ser el caso de "raccoon" o "boardwalk" porque son mas complejas de descubrir y por lo tanto son mas seguras.

 

Navegación de un usuario autenticado versus anónimo

La distinción entre un usuario anónimo y autenticado o logueado es  muy importante:

Navegación anónima

Esta es la forma por defecto de navegar en la web. El usuario escribe la dirección del sitio en el navegador y lee las páginas webs, mira videos, imagánes y no requiere autenticarse. Por esto motivo es llamado anónimo: cualquier persona puede navegar el sitio sin dar a conocer su identidad. Notesé el enlace entrar o log in en la parte superior derecha de la figura. Si un sitio Plone muestra el enlace entrar, esto significa que el usuario no se ha autenticado, y el usuario está navegando de forma anónima:


    

Actividad en modo autenticado

El modo autenticado es el que emplea un sitio web de una tarjeta de crédito, un banco o cualquier otra actividad que requiere una cuenta de usuario. El sitio web de un banco permite ver información sobre la cuenta del usuario, llenar formularios, transferir fondos y otras acciones. Siempre requieren identificación primero. Un sitio Plone no es muy diferente, con la diferencia que se pueden hacer cosas mas sofisticadas. Si se observa la siguiente imagen, el usuario "John Smith" se ha autenticado. A la derecha del usuario identificado por el sistema hay un enlace para cerrar la sesión (log out). Otra diferencia importante, posterior a la autenticación. Sobre el cuerpo principal aparece un encabezado con pestañas verdes. En estas pestañas hay opciones como editar debido a que John Smith tiene suficientes privilegios para modificar el contenido de esta página.

   

Roles de usuario

La distinción entre los diferentes roles de usuarios es muy importante en un sitio Plone. Para ilustrar el caso mas simple, consideresé dos roles de usuarios, miembro y manager. Estos roles tienen diferentes privilegios o "poderes":

Miembro

  • posee una cuenta de usuario y por ello puede autentiarse
  • puede agregar contenido, perso solo en areas especificas y no puede cambiar nada fuera de estas. Estas areas son tratadas con espacios personales donde miembros pueden agregar contenido.
  • no pueden publicar contenido, lo que significa que no es visible a visitantes anónimos, incluso el contenido que los miembros agregaron. Una persona con el rol manager debe aprobar el contenido para que sea publicado.

Manager

  • posee una cuenta de usuario y por ello puede autentiarse
  • puede agregar contenido en cualquier sitio y tiene privilegios para cambiar cualquier cosa
  • puede publicar cualquier contenido

Cuando un usuario puede obtener una cuenta nueva de un sitio Plone, se le debería dar información de las areas donde tiene privilegios para agregar contenido una vez autenticado. Si esto ocurre y el usuario abre la carpeta donde tiene tales privilegios, en la parte superior del contenido se deben visualizar pestañas de color verde con las palabras Contenidos, Vista, Editar, Reglas, Propiedades y Compartir:


Si se hace click en ellas es posible explorar las diferencias entre una y otra, aunque se dará una descripción a modo de guía:

  • Contenidos - muestra una lista con los elementos que posee la carpeta
  • Vista - muestra la vista que un usuario anónimo visualizará
  • Editar - cambia el panel a una vista de edición
  • Reglas - muestra un panel para controlar como son creados y administrados los elementos
  • Compartir - muestra una panel para personalizar privilegios para ver o editar contenido
  • Historia - muestra la vitácora de cambios realizados en un item

Debajo de las pestañas, aparece varios menú que comienzan con las palabras Mostrar, Agregar nuevo... y Estado:

You also see menus in the lower part of the green header strip, Display, Add new..., and State:

  • Mostrar - permite seleccionar el tipo de vista (lista de items, vista de resumen, etc.)
  • Agregar nuevo... -  muestra un menú con los diferentes items de contenidos que se pueden agregar (imágene, página, carpeta, etc.)
  • Estado - permite cambiar el estado de publicación del elemento actual (privado, borrador público, publico, etc.)

Estos menús y pestañas son los medios principales para interactuar con Plone. A medida que el lector aprenda mas sobre administrar un sitio web Plone, mas familiar resultarán.


4. Autenticación 

Cuando el usuario se autentica (loguea) en un sitio Plone

Cuando un usuairo vista un sitio Plone de forma anónima visualizará un botón "entrar" similar a: 

log-in.png

Luego de hacer click en el boton, se verá un formulario donde se debe escribir nombre de usuario y contraseña:  

Luego de autenticarse en un sitio Plone el usuario verá su nombre en la parte superior de la pantalla. Si se hace click en el nombre se accederá a las preferencias personales, texto de presentación del usuario, etc.

5. Setting Your Preferences

After logging in to a Plone web site, you can change your personal preferences for information about your identity and choice of web site settings.

After logging in, your full name will be posted on the right side of the header strip. Click your name to go to your personal area, called the dashboard:

You will see the dashboard panel:

When you log in for the first time, your dashboard will be empty, as the Info message explains. Portlets are specific "views" of different types of content. You can choose which ones you want in your dashboard by clicking the Edit tab, but we'll get to that in a second.  First, let's look at the Profile and Personal Preferences links at top right. Clicking the Profile link brings up a panel that shows your personal profile photograph, if you have uploaded one:

 

After you have created content on the web site, you can come back here to see it nicely listed.  The Edit tab for the profile, or the Personal Preferences link discussed above, will bring up the personal preferences panel:

Date entry fields include:

  • Full Name - If your name is common, include your middle initial or middle name.
  • E-mail address - REQUIRED - You may receive emails from the web site system, or from a message board, if installed, etc. When an item is required, a little red square will show alongside the item.
  • Location text box - This is the name of your city, town, state, province, or whatever you wish to provide.
  • Language preference selection menu - Plone excels at offering multilingual support.
  • Biography text box - Enter a short description of yourself here, about a paragraph or so in length.
  • Home Page web address - If you have your own web site or an area at a photo-sharing web site, for instance, enter the web address here, if you wish, so people can find out more about you.
  • Content Editor selection menu - You have the choice of using Kupu, which lets you edit web pages with a nice graphical interface, or using a basic editing panel, which is good if you are accustomed to writing web pages using HTML (the basic "code" of web pages). The default setting is to use Kupu, and is assumed in this user manual.
  • Enable External Editing checkbox - This is for switching on and off an "external" editor, if one has been installed by the web site administrator. Use of an "external" editor is mainly for web designers and programmers who do more editing of actual code, but it could be useful for volume page creation using specialized text mark-up languages. (Don't worry about this setting if you haven't heard anything about it from your web site administrator).
  • Listed in Searches checkbox - Uncheck this box if you do not want to be listed in searches.  Normally you would want to keep this checked, because having open communications is an important goal of most Plone web sites.
  • Portrait photograph upload - The portrait photograph will appear as a small image or thumbnail-size image, so it is best to use a head shot or upper-torso shot for this.

You can change your preferences whenever you wish.

6. Your Dashboard

A Plone user has a personal "dashboard" for customizing the personal user interface.

Plone has several built-in "views" of news, events, recently changed items, and such. These list views are held in discrete rectangular areas called portlets. Think of a portlet as a window view of a given type of content. For example, the news portlet offers a view of recently published news items.

You control which portlets you view in your dashboard, and where they are placed.  The following screen capture shows what user Elizabeth Smith would see after logging in and clicking her own name at upper right to go to her personal area:

The dashboard appears to be empty for a new user.

Clicking the edit tab for the dashboard will show that there are portlets already assigned to the dashboard -- the dashboard view shown above is empty, because there is no content available for display in the portlets on this new web site. Here are the default portlets:

 

You see the News and Events portlets in the left-most column, the Recent Items portlet in the second column, and the Review List portlet in the right column. The third column does not have a portlet assigned.

A new user account on a basic Plone web site will have a dashboard like the one shown, but for a web site that has been customized with add-on functionality, there may be more portlets to choose from, and the dashboard might start out with several more placed in the columns.  For example, there could be portlets for "current weather," "stock ticker," "quote of the day," etc., depending on what is installed for the web site (such things would require custom software). Depending on what is installed for the site, the user can customize the portlets they want to see and where to place them within the four columns.

So, for the typical Plone user account, the dashboard would start with the portlets shown above, and later would be "populated" as news items, events, and other content items are added to the web site.