# Multi-Domain and Internationalization Guide ## Internationalization ### Translation Files Create translation files in the `translations` directory: **translations/en.json:** ```json { "navigation": { "home": "Home", "about": "About Us", "contact": "Contact" }, "messages": { "welcome": "Welcome to our site!", "greeting": "Hello {name}!" } } ``` **translations/es.json:** ```json { "navigation": { "home": "Inicio", "about": "Acerca de", "contact": "Contacto" }, "messages": { "welcome": "¡Bienvenido a nuestro sitio!", "greeting": "¡Hola {name}!" } } ``` ### Using Translations in Templates ```html [translate(navigation.home)] [t(navigation.home, Home)] [t(messages.greeting, Hello!, {name: John})] ``` Locale detection from request headers or ?locale=es parameter. ## Multi-Domain Setup ### Directory Structure ``` templates/ ├── layouts/ │ ├── default.html │ ├── full-width.html │ └── minimal.html ├── domains/ │ ├── example.com/ │ │ ├── layouts/ │ │ ├── partials/ │ │ │ ├── header.html │ │ │ └── footer.html │ │ ├── cms_forms/ │ │ │ ├── form.html │ │ │ └── field_text.html │ │ ├── page.html │ │ └── index.html │ └── dev.example.com/ │ └── page.html ├── partials/ │ ├── header.html (default) │ └── footer.html (default) ├── cms_forms/ │ ├── form.html │ ├── field_text.html │ └── field_email.html ├── translations/ │ ├── en.json │ ├── es.json │ └── fr.json ├── page.html (base HTML wrapper) └── 404.html ``` ### Template Resolution Order 1. Domain-specific: `templates/domains/{domain}/template.html` 2. Default: `templates/template.html` 3. Base: Package default templates ### Configuration ```javascript const cms = new Manager({ defaultDomain: 'example.com', domainMapping: {'dev.example.com': 'development'}, siteKeyMapping: {'example.com': 'main'} }); ``` ## Layout System The CMS uses a two-tier layout system: **page.html - Full HTML wrapper:** ```html {{title}} {{&content}} ``` **layouts/default.html - Body content only:** ```html

``` **Available Layouts:** Pages can use different layouts by setting the `layout` field in `cms_pages`: - `default` - Header, sidebar, main content, footer - `full-width` - Full width without sidebars - `minimal` - Basic layout with minimal styling ## Content Blocks Create reusable content blocks in the `cms_blocks` table via admin panel: ```sql INSERT INTO cms_blocks (name, title, content) VALUES ('contact-info', 'Contact Information', '

Email: info@example.com

'), ('article-sidebar', 'Article Categories', '