Tips & Chips de ModX

migx-tv-cmp.md

Usar MIGX con una base de datos y TV's

0. Se debe tener instalado el paquete MIGX
1. Se crea una TV en Elements > Template Variables

• General Information
  • Name : [base_name]
• Input Options
  • Input Type : migx
  • Congfigurations : [base_name]

2. Crear un esquema para xPDO, el cuál contiene la información de la base de datos, mas info en: https://docs.modx.com/xpdo/2.x/getting-started/creating-a-model-with-xpdo/defining-a-schema/defining-the-database-and-tables
3. Crear Paquete y cargar esquema en MIGX Management:

• Package Manager > Package
  • Package Name : [nombre_paquete] - Debe coincidir con el del esquema
  • table-prefix : Custom Prefix
  • Create Package
• Package Manager > Xml Schema
  • Load schema
  • Schema : Tiene un esquema cargado por defecto cuando se creo el paquete, se corra el contenido y se pega el esquema previamente creado en el paso 2.
  • Save schema
• Schema > Write schema
• create Tables > create Tables

4. Crear la "Manager Custom Page" para administrar los datos

• En MIGX Management > MIGX > Add item :
• Settings
  • Name : [nombre_paquete]
  • "Add Item" Replacement : Etiqueta personalizada para el botón de agregar
  • unique MIGX ID : [nombre_paquete]
• Formtabs > Add Item
  • Caption : Título del formulario
  • Fields > Add Item : Agregar columnas por cada campo de la tabla que queramos modificar
    • Fieldname : Nombre del campo declarado en Schema
    • Caption : Etiqueta para el campo
    • Input TV type : De acuerdo al tipo de campo, pueden ser https://docs.modx.com/revolution/2.x/making-sites-with-modx/customizing-content/template-variables/template-variable-input-types
• Columns
  • Add Item : Agregar columnas por cada campos de la tabla que queramos mostrar
  • Column:
    • Header : Título de la columna
    • Field : Nombre del campo declarado en Schema
  • Importante!! La columna del campo ID siempre debe estar, para poder modificar o borrar elementos
• Contextmenues
  • Seleccionar:
    • update
    • duplicate
    • publish
    • unpublish
• Actionbuttons
  • Seleccionar
    • addItem
• MIGXdb-Settings
  • Package : [nombre_paquete]
  • Classname : Nombre de la clase que se declaro desde el Schema
• CMP-Settings
  • Main Caption : Título principal
  • Tab Caption : Título del tab
  • Tab Description : Descripción del tab
• Done

5. Crear el acceso desde el menú

• System > Menus
• Seleccionar la unicación del acceso > Create Menu
• Lexicon Key : Cómo se va a llamar el acceso
• Description : preferentemente
• Action : index
• Parameters : &configs=[nombre_paquete]
• Namespace : migx
• Save

modx.md

Para seleccionar que tipos de archivo deja subir al directorio assets

En System Settings & Events filtrar por File System (13) y la variable de entorno Uploadable File Types / upload_files afecta a todo el directorio de assets

Cuando se crea un nuevo contexto bajo el esquema: Dos contextos en distintos subdirectorios con un mismo core

0. Previo se detecta un conflicto con ésta configuración con el paquete ContextRouter en su versión 1.1.0-pl2 por lo que en caso de tenerse debe desistalarse o deshabilitarse.
1. Debe instalarse el paquete XRouting que iniciará automáticamente cada contexto, sin necesidad de crear subdirectorios
2. System > Contexts > Create New

• Context Key : La llave del contexto, después de creado no se puede cambiar y sirve para referenciarlo en todo ModX
• Name y Description : En los valores que correspondan

2. En el nuevo contexto creamos un nuevo documento para el inicio que validará que esté funcionando, se aconseja crear un segundo documento independiente del inicio para verificar el correcto funcionamiento de las url's amigables.
3. System > Contexts > Click Derecho en el contexto creado > Update Context > Context Settings
4. Se crean las siguientes propiedades, en el Namespacede core

Name	Key	Value
base path	base_path	/
base url	base_url	/[Alias del contexto]/
http host	http_host	domain.com
home	site_start	[ID de la página que creamos de prueba dentro del contexto]
site url	site_url	http://domain.com/[Alias del contexto]/

No olvidar click en el botón de save

8. Se limpia el caché