CodePress CMS

A lightweight, file-based Content Management System built with PHP and Bootstrap.

Overview

CodePress is a modern, secure CMS that manages content through files instead of a database. It's designed for simplicity, flexibility, and ease of use while maintaining powerful features for content management.

Features

🎯 Core Features

• File-based content - No database required
• Multi-format support - Markdown, PHP, HTML files
• Dynamic navigation - Auto-generated from directory structure
• Search functionality - Full-text search with snippets
• Breadcrumb navigation - Clear page hierarchy
• Responsive design - Works on all devices

🔧 Advanced Features

• Collapsible folders - Accordion-style navigation
• WCAG compliant - Accessible design with proper contrast
• File metadata - Creation and modification dates in footer
• Progressive styling - Visual hierarchy with nested levels
• Security - Protected PHP files and sensitive directories

Quick Start

1. Requirements: PHP 8.4+
2. Installation:

   git clone https://git.noorlander.info/E.Noorlander/CodePress.git
   cd CodePress
   

3. Start server:

   php -S localhost:8000 -t public
   

4. Visit: http://localhost:8000

Project Structure

codepress/
├── public/                 # Web-accessible directory
│   ├── content/           # Content files (MD/PHP/HTML)
│   ├── assets/            # Static assets (images, icons)
│   └── .htaccess          # Security and routing
├── templates/             # HTML templates
├── config.php             # Site configuration
├── index.php              # Main application logic
├── .htaccess             # Root security
└── README.md             # This documentation

Security

CodePress includes built-in security features:

• .htaccess protection for sensitive files
• PHP file blocking in content directory
• Security headers for XSS protection
• Directory access control
• Public directory isolation

Content Management

Supported File Types

Markdown (.md)

# Page Title

Content with **bold** and *italic* text.

[Link to page](?page=other/page)

PHP (.php)

<?php
$title = "Dynamic Page";
$date = date('Y-m-d');
?>

<h1><?php echo $title; ?></h1>
<p>Date: <?php echo $date; ?></p>

HTML (.html)

<h1>Static HTML Page</h1>
<div class="alert alert-info">
    Custom HTML content
</div>

Directory Structure

public/content/
├── home.md              # Homepage
├── about/
│   └── company.md      # About page
├── blog/
│   ├── tech/
│   │   └── post.md     # Blog post
│   └── index.md        # Blog overview
└── projects/
    └── web-design.md   # Project page

Configuration

Edit config.php to customize:

return [
    'site_title' => 'Your Site Name',
    'site_description' => 'Your site description',
    'content_dir' => __DIR__ . '/public/content',
    'default_page' => 'home',
    'markdown_enabled' => true,
    'php_enabled' => true,
];

Branches

• main: Clean CodePress CMS with documentation
• e.noorlander: Personal blog content and customizations
• development: Active development branch

Development

Adding Features

1. Create feature branch from development
2. Implement changes
3. Test thoroughly
4. Submit merge request

Contributing

• Follow PSR-12 coding standards
• Test security implications
• Update documentation
• Maintain backward compatibility

License

This project is developed for specific use cases. Contact the maintainer for licensing information.

Support

• Documentation: See public/content/home.md
• Issues: Report on GitLab
• Community: Join discussions

---

Built with ❤️ and PHP