Hachesepéh Traqueteando sarabasas..

Documentación

Documentación original (Inglés)

El uso de LokiCMS es muy simple. Si necesitas ayuda acerca del uso general o sobre características mas complejas, deberías revisar esta documentación. Se trata de un trabajo aún sin completar pero es válido hasta la version 0.3.1.

Tópicos

  • Instalacion
  • Administrando su sitio
  • Modificando LokiCMS
  • Creando un modulo
  • Trabajando con temas/estilos

Instalación

Descripción en progreso

Administrando su sitio

Descripción en progreso

Modificando LokiCMS

Descripción en progreso

Creando un Módulo

LokiCMS esta diseñado en forma modular. En este caso, un modulo representa la parteq ue procesa la página y la combina con el contenido HTML del tema. Por lo tanto, cuando cierta página es cargada, se revisa la existencia de la misma en la carpeta "/pages" y el modulo que lo acompaña es cargado para procesar la información de esa página en particular. Es recomendable que leas esto, antes de modificar LokiCMS.

Un módulo consiste de 2 archivos:
El primero, module.php, contiene la descripción del modulo.

<?
// technical
$modulename = "Normal"; (- el nombre del módulo)
$modulecode = "lcd"; (- la extension del archivo)

// info
$moduleversion = "0.3.0"; (- la version del módulo)
$modulefullname = "Lokicode module"; (- descripción completa del modulo)
$moduleauthor = "Ynte de Wolff" (- autor del módulo)
?>

El segundo archivo contiene el modulo en sí y se llama functions.php:

<?
function module($something) {
(este modulo será llamado cuando la página deba ser cargada.
Puedes hacer lo que quieras con el ingreso de datos y modificar el resultado para
que retorne el contenido a mostrar dentro en la página)
return $return;
};
function moduleedit($page) {
(este modulo es llamado al editar la página en el panel de administracion.
Basicamente, contiene la interface de edicion)
};
function modulesave($page) {
(este modulo es llamado al guardar los cambios de edicion de una página.
Puedes, por ej, verificar si un $_POST ha sido completado con información y,
de ser asi, que guarde los cambios de la página)
};
function modulenew($page) {
(este modulo es llamado cuando se crea un nuevo archivo o página para
este módulo en particular. Constituye la interface de nueva pagina.)
};
?>

Espero que esta simple explicacion sea suficiente para iniciarte en el tema.
Con el tiempo, esta sección se irá mejorando.

Trabajando con temas/estilos

LokiCMS ha sido diseñado para integrarse con la mayoría de temas o plantillas (plantiilas xhtml en general), con muy poco trabajo de edicion. A continuación se explicará como hacer esto.

Cada tema está ubicado dentro de una carpeta, las cuales se encuentran en la carpeta "/themes". El nombre de la primer carpeta es también el nombre del tema. El archivo principal es el index.php, asi que debes renombrar el archivo original (index.html, la mayoria de las veces) a ese nombre. Otro punto importante es tener en cuenta que todos los recursos son relativos a la ubicación de LokiCMS y no a la ubicación del tema. Por ejemplo:

Correcto:    <link href="themes/name/default.css" rel="stylesheet" type="text/css" />
Incorrecto:   <link href="default.css" rel="stylesheet" type="text/css" />

Lo mismo se aplica a las imágenes.

Para integrar los contenidos, se utilizan los siguientes tags, que deberán reemplazarse por los contenidos en el theme original:

%title% - el titulo de la página o ventana
%header% - el titulo del header
%tagline% - la descripcion o header pequeño
%menu% - la lista o menú que contiene las paginas activas, cuya salida es asi:

<ul>
<li><a href="index.php?page=Index.lcd">Index</a></li>
<li><a href="index.php?page=Features.lcd">Features</a></li>
<li id="active"><a href="index.php?page=Documentation.lcd">Documentation</a></li>
<li><a href="index.php?page=Themes.lcd">Themes</a></li>
</ul>

(el id="active" te notifica que ese item es el verá el usuario)
%pagecontent% - el contenido de la página en XHTML
%footer% - el texto o descripción del footer

Estos códigos o tags son más que suficientes para integrar casi cualquier plantilla a LokiCMS. No es necesario que los utilices todos. Esperamos mejorar este sistema en futuras versiones.