FlintmanCMS

A lightweight, PHP-based Content Management System (CMS) with Smarty templating, designed for easy customization and extensibility.

Features

• Admin and user management
• Page, plugin, and group management
• Smarty template support for easy theming
• Responsive design (mobile and desktop)
• MySQL database backend
• Dockerized for easy setup
• GPL v2 Licensed

---

Quick Start (with Docker)

Prerequisites

• Docker (version 20+ recommended)
• Docker Compose (if not included with Docker)

1. Clone the Repository

git clone https://github.com/flintman/flintmancms.git
cd flintmancms

2. Build and Start the Containers

docker-compose up --build

• This will build the PHP/Apache and MySQL containers, initialize the database, and start the CMS.

Note: You may need to change the permissions of the html folder so the web server can write to it:

sudo chown -R www-data:www-data html

This is especially important for folders like templates_c/ that require write access.

3. Access the CMS

• Open your browser and go to: http://localhost:3000
• Default admin login: (username:admin password:admin) CHANGE RIGHT WAY

4. Stopping the Containers

docker-compose down

---

Manual Installation (Non-Docker)

1. Install PHP 7.4+ and MySQL 5.7+ (or MariaDB)
2. Copy the project files to your web root
3. Import the database schema from db_init/schema.sql
4. Configure database credentials in html/includes/authentication.php or your config file
5. Set file permissions for templates_c/ and uploads/ (if used)
6. Access via your web server (Apache/Nginx)

---

File Structure

• html/ - Main PHP source code
• html/templates/ - Smarty templates
• html/includes/ - Core PHP includes (DB, auth, menu, etc.)
• db_init/ - Database schema and initialization scripts
• docker-compose.yml - Docker Compose configuration
• Dockerfile - PHP/Apache Docker build
• docs/ - Documentation and license

---

Updating

• Pull the latest code:

  git pull origin main
  docker-compose build --no-cache
  docker-compose up -d

• Review docs/updates for version changes.

---

License

This project is licensed under the GNU General Public License v2.0. See html/docs/gpl-2.0.txt for details.

---

Support & Contributions

• Issues: GitHub Issues
• Pull requests welcome! Please follow the code style and include clear commit messages.
• For questions, contact the maintainer or open an issue.

---

Credits

• Flintman Computers (original author)
• Smarty Template Engine
• All contributors and open source libraries used

---

Security

• Change default passwords after install
• Keep Docker, PHP, and MySQL up to date
• Review and restrict file permissions as needed

---

Troubleshooting

• If you see database errors, check the MySQL container logs: docker-compose logs db
• For permission issues, ensure templates_c/ is writable by the web server
• For more help, see the docs/ folder or open an issue

---

Enjoy using FlintmanCMS!