Edwin Noorlander
561832161e
- Remove H1 and HTML title extraction from parse methods - Always use formatDisplayName() for consistent filename-based titles - Add file path parameters to parseMarkdown() and parseHTML() - Fix directory precedence to check directories before files - Update AGENTS.md with title vs filename clarification - Remove debug code from templates and methods Resolves: Page titles now consistently show file/directory names without language prefixes and extensions, never content titles.
29 lines
1.8 KiB
Markdown
29 lines
1.8 KiB
Markdown
# Agent Instructions for CodePress CMS
|
|
|
|
## Build & Run
|
|
- **Run Server**: `php -S localhost:8080 -t public`
|
|
- **Lint PHP**: `find . -name "*.php" -exec php -l {} \;`
|
|
- **Dependencies**: No Composer/NPM required. Native PHP 8.4+ implementation.
|
|
|
|
## Code Style & Conventions
|
|
- **PHP Standards**: Follow PSR-12. Use 4 spaces for indentation.
|
|
- **Naming**: Classes `PascalCase` (e.g., `CodePressCMS`), methods `camelCase` (e.g., `renderMenu`), variables `camelCase`, config keys `snake_case`.
|
|
- **Architecture**:
|
|
- Core logic resides in `index.php`.
|
|
- Configuration in `config.php`.
|
|
- Public entry point is `public/index.php`.
|
|
- **Content**: Stored in `public/content/`. Supports `.md` (Markdown), `.php` (Dynamic), `.html` (Static).
|
|
- **Templating**: Simple string replacement `{{placeholder}}` in `templates/layout.html`.
|
|
- **Navigation**: Auto-generated from directory structure. Folders require an index file to be clickable in breadcrumbs.
|
|
- **Security**: Always use `htmlspecialchars()` for outputting user/content data.
|
|
- **Git**: `main` is the clean CMS core. `e.noorlander` contains personal content. Do not mix them.
|
|
|
|
## Important: Title vs File/Directory Name Logic
|
|
- **CRITICAL**: When user asks for "title" corrections, they usually mean **FILE/DIRECTORY NAME WITHOUT LANGUAGE PREFIX AND EXTENSIONS**, not the HTML title from content!
|
|
- **Examples**:
|
|
- `nl.test.md` → display as "Test" (not content title)
|
|
- `nl.test/` directory → display as "Test" (not H1 content)
|
|
- `en.php-testen` → display as "Php Testen" (not "ICT")
|
|
- **Method**: Use `formatDisplayName()` to process file/directory names correctly
|
|
- **Priority**: Directory names take precedence over file names when both exist
|
|
- **Language prefixes**: Always remove `nl.` or `en.` prefixes from display names |