Integrar y ajustar módulos CMS
En este tutorial, adaptas el módulo del blog del CMS bluetronix: desde la activación e integración de la lista del blog hasta archivos de módulo propios, valores de configuración y archivos de idioma.
Requisitos y objetivo del tutorial
Para este tutorial necesitas un acceso de desarrollador al CMS bluetronix. Ya deberías saber cómo funcionan las carpetas de desarrollador y por qué los archivos propios en las carpetas del sistema se marcan con _own.
Usamos el módulo existente de Noticias - Blog como ejemplo. Activarás el módulo, integrarás su vista de lista en una página de CMS y luego ajustarás específicamente un archivo de módulo propio así como la configuración. Los archivos originales permanecen sin cambios.
1. Activar el módulo del blog
Abre en el CMS Módulos y selecciona Noticias - Blog.
Activa la opción Activar módulo del blog y confirma la consulta de seguridad con OK.
A continuación, tendrás disponible el configurador del módulo. A la izquierda se encuentran las configuraciones técnicas, a la derecha los textos del módulo dependientes del idioma.
2. Incluir lista de blog en una página del CMS
Abre la página /Blog/index.html y selecciona Código HTML. La página del blog se integra mediante una breve etiqueta de CMS.
<!--bx_Mod/Blog/Modul-Blog-List-->
La etiqueta hace referencia al módulo del blog y su vista de lista. El CMS inserta en este lugar la salida generada del módulo al renderizar.
3. Abrir archivos de módulo centrales en el gestor de archivos
La lógica real de PHP y HTML de los módulos no se encuentra directamente en el HTML de la página, sino centralmente en la carpeta del sistema bx_Mod. Abre primero esta carpeta en el Gestor de archivos y luego la subcarpeta Blog.
En la carpeta del blog, encontrarás por ejemplo Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, otros archivos de módulo y la subcarpeta languages.
4. Ver archivo estándar de la lista de blog
Selecciona Módulo-Blog-List.php y ábrelo a través de Editar.
El archivo estándar contiene la lógica del programa para la vista de lista. En el código mostrado se incluyen, entre otras cosas, la configuración del módulo y, si existe, el config_own.php específico del proyecto.
De esta manera, una sola inclusión del módulo puede utilizar la misma lógica central del programa en varias páginas. Para proyectos que utilizan el módulo estándar, las actualizaciones posteriores del CMS pueden ofrecer cambios en este archivo.
No edites directamente el Módulo-Blog-List.php original. Pertenece al sistema y puede ser sobrescrito en una actualización del CMS.
5. Crear una vista de lista propia con _own
Para cambiar la salida por ti mismo, copia el archivo estándar. La copia propia recibe la etiqueta _own correspondiente:
Modul-Blog-List.php
↓ kopieren
Modul-Blog-List_own.php
Abre el nuevo archivo Módulo-Blog-List_own.php. En esta versión específica del proyecto, puedes modificar la lógica PHP y la salida HTML sin tocar el archivo estándar.
En nuestra prueba, añadimos la llamativa secuencia de caracteres NEW!!!! al título. El resto de la vista de lista permanece igual.
Guarda tu archivo del módulo propio y vuelve a cargar la página del blog. El CMS utiliza la variante _own correspondiente, mientras que el marcador en /Blog/index.html permanece sin cambios. Reconocerás el archivo propio activo por el título cambiado NEW!!!! ARTÍCULOS MÁS NUEVOS.
6. Configuraciones del módulo y tu propia configuración
Además de la salida HTML, también puedes cambiar la configuración del módulo. La captura de pantalla muestra en el configurador, por ejemplo, para Módulo-Blog-ShowCase el valor DS Repeats = 3.
Cambia el valor a 2 y guarda la configuración. Con esto, se establece el número deseado para esta área de ShowCase. La configuración se refiere a Módulo-Blog-ShowCase y no se debe considerar automáticamente igual al número de todos los artículos de la vista de lista del blog.
La configuración propia se encuentra en bx_Mod/Blog/config_own.php. Selecciona este archivo en el administrador de archivos.
El config_own.php mostrado sobrescribe el valor solo cuando se carga la sección del módulo Módulo-Blog-ShowCase:
if($ModulNameGB == "Modul-Blog-ShowCase") {
$CF_DS_Repeats = 2;
}
Los valores predeterminados continúan proveniendo de config.php. Por lo tanto, un archivo de configuración propio no necesita repetir todos los valores predeterminados, sino que puede contener solo las desviaciones deseadas.
7. Establecer tabla de base de datos y páginas de módulo
En la configuración estándar bx_Mod/Blog/config.php, encontrarás, entre otras cosas, la tabla de base de datos utilizada, así como las rutas a la vista de detalle y lista. En el ejemplo mostrado, los valores son:
$CF_DatabaseTable = "Blog";
$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";
Si desarrollas una variante propia para un propósito diferente basada en el módulo del blog, puedes en tu propia configuración, por ejemplo, especificar otra tabla de base de datos. Asegúrate de que la nueva tabla contenga los campos que tu archivo de módulo espera y que las páginas de lista y detalle se ajusten a la nueva variante.
8. Archivos de idioma del módulo
Bajo bx_Mod/Blog/languages, se encuentran los archivos de idioma del módulo del blog. Para los idiomas existentes, hay archivos PHP separados, como de.php, en.php y fr.php.
Aquí se gestionan los textos del módulo dependientes del idioma. Para cambios específicos del proyecto, usa el formato de archivo propio compatible con tu versión del módulo, en lugar de sobrescribir directamente los archivos de idioma originales.
9. Diferenciar entre módulo estándar y tu propia versión
La regla _own protege tus adaptaciones de ser sobrescritas por actualizaciones regulares. Al mismo tiempo, eres responsable del mantenimiento de esta versión individual. Al realizar actualizaciones del CMS más adelante, verifica si los cambios importantes en el archivo estándar también son relevantes para tu propio archivo.
10. Resumen
Activas el módulo del blog en Módulos → Noticias - Blog, integras la vista de lista a través de una marca del CMS y gestionas la lógica central del programa bajo bx_Mod/Blog. Para tus propios cambios, copias Módulo-Blog-List.php a Módulo-Blog-List_own.php. Las configuraciones que se desvían del estándar se pueden especificar según sea necesario en config_own.php.
CMS-Seite /Blog/index.html
↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-SeiteDe esta manera, se puede ampliar un módulo existente de manera específica, sin alterar los archivos del sistema originales.
Preguntas Frecuentes
lo que los clientes nos preguntan con frecuencia
¿Qué acceso necesito para personalizar módulos de CMS?
Necesitas un acceso para desarrolladores al CMS de bluetronix. Además, deberías conocer las carpetas de desarrollador y la regla _own.
¿Dónde activo el módulo de blog?
Abre Módulos, selecciona Noticias - Blog y activa Activar módulo de blog. Confirma la consulta de seguridad.
¿Cómo integro la lista de blogs en una página de CMS?
Abre el código HTML de la página deseada e inserta la etiqueta del módulo <!--bx_Mod/Blog/Modul-Blog-List-->.
¿Debo copiar el código PHP completo de la lista de blogs en la página?
No. La página solo contiene la etiqueta del módulo. La lógica correspondiente se carga de forma central desde el módulo de blog.
¿Dónde se encuentra el archivo estándar de la lista de blogs?
Lo encontrarás en bx_Mod/Blog/Modul-Blog-List.php en el área de desarrolladores del gestor de archivos.
¿Cómo adapto un archivo de módulo de manera que se pueda actualizar?
Copia el archivo estándar y etiqueta la copia con _own, por ejemplo Modul-Blog-List_own.php. Luego, edita solo este archivo propio.
¿Debo cambiar la etiqueta del módulo al crear un archivo _own?
No. Para un archivo de módulo compatible con el CMS, se puede utilizar automáticamente la variante _own correspondiente sin cambiar la integración del módulo existente.
¿Para qué se necesita config_own.php?
A través de bx_Mod/Blog/config_own.php puedes sobrescribir valores individuales de la configuración estándar de manera específica para el proyecto.
¿Qué efecto tienen los DS Repeats en este ejemplo?
En el ejemplo mostrado, la configuración para Modul-Blog-ShowCase se cambia de 3 a 2. Esto establece el número de repeticiones de esta área del módulo.
¿Dónde se establece qué tabla de base de datos utiliza el módulo de blog?
En la configuración bx_Mod/Blog/config.php se indica en el ejemplo $CF_DatabaseTable = "Blog";. La asignación se puede ajustar para una variante de módulo propia.
¿Dónde encuentro los archivos de idioma del módulo de blog?
Los archivos PHP dependientes del idioma se encuentran en bx_Mod/Blog/languages, por ejemplo de.php y en.php.
¿Quién se encarga del mantenimiento de un archivo de módulo propio?
El archivo _own permanece intacto en actualizaciones regulares del CMS. El desarrollador debe verificar por sí mismo si se deben incorporar nuevas correcciones de errores o funciones del archivo estándar.