Funciones
Llamamos funciones a cada actividad temática que se puede hacer en Navigate CMS: Elementos, Bloques, Estructura... Por supuesto, ¡la gestión de funciones también es una función! A menos que quieras desarrollar alguna nueva funcionalidad en Navigate CMS, no tendrás que utilizar esta función.
La función Funciones utiliza dos vistas: Lista y Formulario.
Lista
Al igual que con otras listas en Navigate CMS:
- Haz clic en una fila para seleccionarla/deseleccionarla
- Haz doble clic o una pulsación larga en una fila para cargar el formulario de edición
- Ctrl + doble clic en una fila para abrir el formulario de edición en una nueva pestaña/ventana
- Mueve la barra de desplazamiento para obtener más elementos
- Encuentra filas con el pequeño buscador situado en la parte superior derecha
Formulario
El formulario de edición de Funciones tiene una sola pestaña: Principal. Contiene 6 campos:
- ID — identificador numérico de la función o (nueva) si se trata de una nueva función
- Categoría — grupo temático de la función (utilizado en la función Menús), es un campo de texto libre, aunque Navigate CMS define los siguientes grupos temáticos de forma predeterminada:
- admin — herramientas de administración
- config — funciones de configuración y preferencias
- contenido — funciones para gestionar el contenido de un sitio web
- tienda — funciones para gestionar una tienda (disponible en futuras versiones)
- herramientas — herramientas del sitio web inclasificables: extensiones, boletines...
- web — funciones para administrar las propiedades de un sitio web: estructura, temas...
- Código — nombre en clave de funcionamiento interno que será utilizado en las rutas de Navigate CMS (?fid=codigo_función)
- Icono — ruta relativa al icono de 16x16 de la función (en el directorio raíz de Navigate CMS)
- #Título (lid) — número asignado al título de la aplicación en el diccionario de Navigate CMS
- Activado — define si la función es visible/ejecutable u oculta
Crear nuevas funciones
Se pueden crear nuevas funciones en Navigate CMS pero debes saber que si se añaden nuevas funciones pueden llegar a sobreescibirse tus cambios. Ten esto en cuenta cuando hagas actualizaciones automáticas o manuales.
Si hay suficiente interés, podemos mejorar esta área de la aplicación. En este momento sólo se explican los conceptos básicos.
Todas las funciones se encuentran en lib/packages. Cada función tiene su propia carpeta titulada con su nombre interno. Dentro de esa carpeta debe existir por lo menos un archivo llamado codigo_interno_de_la_función.php. Ejemplo:
- lib/packages/blocks/blocks.php
El último requisito es escribir su función principal, la que se ejecuta cada vez que el usuario hace algún tipo de interacción:
function run()
{
switch($_REQUEST['act'])
{
case 'form':
// tratar los campos de un formulario enviado
// generar el formulario en HTML
$out = mifuncion_form();
break;
default:
case 'list':
// generar la lista de contenidos en HTML
$out = mifuncion_list();
break;
}
// devolver tu HTML generado a Navigate CMS
return $out;
}
Así que no tienes que utilizar echo, print o <?= para enviar HTML al navegador. En su lugar, guarda todo en una variable y pásala a Navigate CMS. La aplicación se encargará de mostrarlo en la zona de contenido principal.
La interfaz de Navigate CMS tiene su propio diccionario ubicado en lib/lang. Se trata de un conjunto de archivos .inc en formato de texto plano. Cada línea representa una cadena traducible y comienza con un número seguido de un # y la traducción para ese idioma. Puedes añadir nuevas líneas pero las actualizaciones pueden eliminarlas, por lo que siempre recomendamos tener una copia de seguridad de tu trabajo. Otra opción es crear y utilizar tus propios diccionarios.
0 Comentarios