LiveCMS Administrador de Contenidos

Guía para desarrolladores

Autor original: Daniel Calisaya (daniel@calisaya.com)
Contribuidores:

Referencia de los templates

Sobre Las plantillas

Introducción

Usted puede cambiar el diseño de su website para cada categoria. La opción de las plantillas le permite que su sitio sea única. Las paginas que se pueden cambiar son: índice de categoría, los titulares de la categoría, la página de detalle, incluso la página de impresión del artículo. Para hacer esto, usted tendrá que crear las plantillas adicionales en los directorios apropiados.

Descripcion detallada

El adminitrador de contenidos lo hace fácil para los usuarios configurar sus plantillas para satisfacer el diseño de cualquier website.

Todas las plantillas usadas por LiveCMS pueden encontrarse en el directorio /templates/ . Estos archivos no se despliegan directamente en su sitio sino se usan como las plantillas para "publicar" todos los contenidos. Recomendamos que use editor de un texto ó un editor de HTML. Las plantillas usan las etiquetas especiales para definir e insertar la información y usando un editor WYSIWYG de HTML pueden ser problemáticos, asegurese que su editor vea las etiquetas especiales.

Si usted usa un editor WYSIWYG (Dreamweaver), guarde una copia de la plantilla original, haga sus modificaciones, para asegurarse que toda la plantilla especial, etiqueta y los placeholders están en sus lugares apropiados.

Cada plantilla tiene varios variables o "placeholders" que pueden ser insertados para decir qué información se va a mostrar en la página publicada. Un placeholder normalmente se parece una palabra en MAYUSCULA rodeada por dos símbolos { }. Ejemplo: {TITULO} {DETALLE}

Además, algunas plantillas usan BLOQUES. Un bloque es para desplegar varias filas como la navegacion y puede desplegarse en diferentes formas. Un ejemplo de bloques se muestra debajo.

<!-- BEGIN row -->
{TITULO}
<!-- END row -->

El segundo ejemplo muestra dos bloques Categorías y subcategorías.

<!-- BEGIN row2 -->
{CAT_TITULO}
<!-- BEGIN row -->
{SUB_TITULO}
<!-- END row -->
<!-- END row2 -->

Se puede agregar o puede quitar el tantos placeholders como usted desea de las plantillas, se ignorarán los placeholders no válidos y se quitarán cuando sea publicada. Si un placeholder no está insertando información, verifique que ha entrado los placeholder exactamente. El nombre del placeholder y los nombres de los bloques son ambos caso-sensible, también mayúsculas y minúsculas son importantes. {ESTO} no es igual a {Esto} o {TITULO} no es igual a {TITULO }, de lo contrario no mostrará el contenido.

Personalizando el HTML

Antes que nada, tome una copia de todas sus plantillas. Algunas veces se pierden los placeholders y bloques es hace que no se vea algunos de sus contenidos. La copia le servirá de ayuda y de referencia.

Luego, siéntase libre para hacer todos los cambios necesarios. La cosa mejor para revisar cualquier archivo de la plantilla sería un editor del texto, pero cualquier otro editor de HTML debe trabajar.

Nombres o Placeholdes globales

Estos datos se pueden mostrar en todas las paginas. Por ejemplo, si en una platilla pone {CMS_TITULO} aparecera el "Título de su sitio".

- Sitio en general

Los placeholders estan definidos por el prefijo CMS_

{CMS_ACTIVO} => Define si el sitio esta activo o en mantenimiento, si no esta activo se mostrará el archivo offline.html
{CMS_TITULO} => Titulo del sitio
{CMS_HOME} => Título para ir a la portada
{CMS_SITEURL} => URL del sitio, ejemplo: http://livecms.com
{CMS_PRIVACIDAD} => URL para la declaración de privacidad, ejemplo: http://livecms.com/privacidad.html
{CMS_TEMPLATE} => Path de los templates, ejemplo: /home/username/public_html/templates
{CMS_CONTACTO} => Email del contacto
{CMS_WEBMASTER} => Email del webmaster
{CMS_COMPANIA} => Nombre de la compañia
{CMS_DIRECCION} => Dirección de la compañia
{CMS_DESCRIPCION} => Descripción del sitios
{CMS_IMAGES} => Ubicacion de las imágenes, ejemplo /images  Nota: esta dirección se combina con el url del sitio, ejemplo: {CMS_SITEURL}/{CMS_IMAGES} que dará como resultado, http://livecms.com/images
{CMS_DEVELOP} => Define si el sitio está en forma de desarrollo o en vivo, los valores son (1,0). Si está en desarrollo mostrará los signos {}, de lo contrario ocultará todos los placeholders.
{CMS_BIENVENIDA} => Este es para indicar el ID del artículo de bienvenida, el valor es (1)
{CMS_COMENTARIOS} => El valor es (1,0), permite habilidar la opcion de comentarios
{CMS_KEYWORDS} => Son las palabras claves del sitio
{CMS_VOTACIONES} => El valor es (INT), permite votar por los artículos
{CMS_VERSION} => La version del sistema

- Header o cabecera de sitio

El header muestra la información global del sitio y tambien de la sección específica. La principal característica del header es mostrar los meta tags del sitio, el logo, y algunos otros datos como la fecha, etc.

<meta name="origen" content="LiveCMS {CMS_VERSION}">
<meta name="description" content="{CMS_DECRIPCION}">
<meta name="author" content="{CMS_CONTACTO}">
<meta name="organization" content="{CMS_COMPANIA}">
<meta name="lang" content="{IDIOMA}">
<meta name="keywords" content="{CMS_KEYWORDS}">
<meta name="revisit-after" content="31 Days">
<meta name="ROBOTS" CONTENT="ALL">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title>{CMS_TITULO} - {CMS_HOME} :: {TITULO}</title>

 

- Navegación de categorias y sub categorías

Es representado por un bloque llamado {CATEGORIA}, este bloque contiene el prefijo CAT_ para categorías y SUB_ para subcategorías. En cualquier logar que ponga {CATEGORIA} motrará las categorías y subcategorias del sitio.

Detalles del bloque principal:
{CAT_TITULO} =>Titulo de la categoria
{CAT_LINK} => Link de la categoría, si existe un link a otro sitio, ejemplo http://php.net se irá directamente a este sitio de lo contrario ira a la categoria especifica
{CAT_TARGET} => Es destino del link, si puso nueva ventana en el admin, se abrirá en nueva ventana.
{CAT_ID} => ID de la categoría

Detalles de bloque segundario:
{SUB_TITULO} =>
{SUB_LINK} =>
{SUB_TARGET} =>
{SUB_ID} =>

Pagina principal (home)

El arrchivo se encuentra en: /templates/index.html

Esta página se define en el siguiente concepto:

HEADER
CATEGORIAS Artículo principal Noticia principal
Publicadad Artículos secundarios Noticias Secundarias
FOOTER

Cada placeholder {HEADER} es un bloque que llama otra página. Esto significa que el home lo conforman varios bloques.

- Artículo principal

se encuentra en: /templates/art_main.html
Esto se usa tanto para el home, como para las categorías y sub categorías. Se define por el prefijo MAIN_ y los datos principales que muestra son:
{MAIN_AID} => ID del artículo
{MAIN_CID} => ID de la categoria o sub categoria
{MAIN_CID_TITULO} => Titulo de la categoria o sub categoria
{MAIN_TITULO} => Titulo del artículo
{MAIN_FECHA} => Fecha de publicacion del artículo
{MAIN_IMAGE} => Imagen pequeña (si existe)
{MAIN_RESUMEN} => Resumen
{MAIN_VISITAS} => Numero de lecturas
{MAIN_FUENTE} => Fuente del artículo
{MAIN_USERID} => La persona que ingreso el contenido