ContentCove

ContentCove is an open-source CMS built using the Symfony Framework, designed for managing blog posts, pages, and contact forms. It supports internationalization (i18n) to ensure content can be translated into multiple languages.

Getting Started

Prerequisites

• PHP 8.1 or higher
• Composer
• MySQL/MariaDB

Installation

1. Clone the repository:

git clone https://github.com/hyperclock/ContentCove.git 
cd ContentCove

2. Install dependencies using Composer:

composer install

3. Set up your .env file with database credentials and other necessary configurations.

4. Run migrations to set up the database schema:

bin/console doctrine:migrations:migrate

5. Load fixtures (optional):

php bin/console doctrine:fixtures:load

• If you want to append fixtures instead of clearing the database, you can use the --append option.

php bin/console doctrine:fixtures:load --append

6. Clear the cache

php bin/console cache:clear

7. Start the Symfony server:

symfony server:start

Directory Structure

• bin/: Contains executable scripts.
• config/: Configuration files for various services and bundles.
• public/: The web root directory, containing index.php and other static assets.
• src/: Source code of the application.
  • Controller/: Controller classes handling incoming requests.
  • Entity/: Doctrine entity classes representing database tables.
  • Repository/: Repository classes for accessing data from the database.
  • Service/: Service classes providing business logic.
  • Twig/: Twig templates and extensions.
• tests/: Unit tests and functional tests.
• var/cache/, var/logs/, etc.: Cache, log files, and other runtime directories.

Dependencies

Ensure you have the following dependencies installed:

• PHP (8.1 or higher)
• Composer
• MySQL/MariaDB

Run composer install to install all required PHP packages.

Configuration

Update your .env file with the following environment variables:

DATABASE_URL=mysql://user:password@localhost/dbname 
MAILER_DSN=smtp://user:[email protected]

Contributing

Contributions are welcome! Please follow these guidelines:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make changes and commit them with descriptive messages.
4. Push to your forked repository.
5. Open a pull request.

Code Style

Follow Symfony's coding standards by running:

./bin/php-cs-fixer fix --config=.php_cs.dist src/

Testing

Run unit tests using PHPUnit:

./vendor/bin/phpunit

Functional tests can be run with Behat (if configured).

License

ContentCove is released under the MIT License.