Файлова структура теми (templates)

# Themes Architecture

This document defines the official filesystem structure, rules and contracts
for the `/themes` directory.

The `/themes` layer is responsible only for presentation.
All business logic, plugins and data access are handled by the CMS core.

Themes consume runtime data objects provided by the CMS and render output using
engine-specific conventions.

---

## DIRECTORY STRUCTURE

```text
/themes
│
├── README.md ← this file (global themes specification)
│
├── ms/ ← Maksoft native rendering engine
│ ├── theme.json ← engine defaults (optional)
│ ├── cms_assets.php ← engine-level CSS/JS definitions
│ ├── functions.php ← engine-level helpers and hooks
│ │
│ ├── helpers/ ← engine helper fallbacks
│ │ ├── meta_tags.php
│ │ ├── footer_inc.php
│ │ └── breadcrumbs.php
│ │
│ ├── components/ ← reusable engine view components
│ │ ├── menu.php
│ │ ├── navigation.php
│ │ └── subpages.php
│ │
│ └── base/ ← base themes
│ ├── theme.json ← base defaults (optional)
│ │
│ └── none/ ← reference theme
│ ├── theme.json ← theme-level config (optional)
│ ├── index.php ← theme entry point
│ ├── meta_tags.php
│ ├── footer_inc.php
│ │
│ ├── layout/
│ │ ├── head.php
│ │ ├── header.php
│ │ ├── footer.php
│ │ └── scripts.php
│ │
│ ├── partials/
│ │ ├── menu.php
│ │ ├── breadcrumbs.php
│ │ ├── subpages.php
│ │ └── banners.php
│ │
│ ├── helpers/
│ │ └── text_format.php
│ │
│ ├── assets/
│ │ ├── css/
│ │ ├── js/
│ │ └── images/
│ │
│ └── README.md ← theme-specific documentation
│
├── wp/ ← WordPress-compatible themes (future)
└── joomla/ ← Joomla-compatible themes (future)