Initialisation du Projet

Installer Blackcube CMS dans un projet Yii2 et vérifier que l'installation fonctionne correctement. Cette étape crée la structure de base de données et configure l'accès au back-office.

Blackcube se compose de deux packages Composer :

blackcube/core : Le cœur du CMS (obligatoire) blackcube/admin : L'interface d'administration (recommandé)

Dans votre projet Yii2, installez les packages :

    composer require blackcube/core
composer require blackcube/admin
    

Ajoutez le module Blackcube dans votre configuration webapp :

    'modules' => [
    'blackcube' => [
        'class' => blackcube\core\Module::class,
        'slugSensitive' => false,
    ],
]
    

1. false : /général et /general sont identiques (recommandé)
2. true : /général et /general sont différents

slugSensitive : Définit si les URLs sont sensibles aux accents

Ajoutez le module admin dans votre configuration webapp :

    'modules' => [
    'bo' => [
        'class' => blackcube\admin\Module::class,
        'adminTemplatesAlias' => '@app/admin',
        'additionalAssets' => [],
        'modules' => [],
    ],
]
    

adminTemplatesAlias : Chemin vers les templates d'admin personnalisés additionalAssets : Assets CSS/JS additionnels pour le backoffice modules : Sous-modules admin (pour plugins)

Exécutez les migrations pour créer les tables Blackcube :

    # Migration de la DB
php yii.php migrate

# Initialisation des droits RBAC
php yii.php bc:init

# Création de l'administrateur initial
php yii.php bc:admin/create
    

Fichier .htaccess dans le dossier public :

    RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php
    

Configuration minimale :

    location / {
    try_files $uri $uri/ /index.php?$args;
}
    

Accédez à l'interface d'administration :

    http://votre-site.local/bo
    

Connectez-vous avec les identifiants créés lors de bc:admin/create.

1. Gestion → Rubriques
2. Gestion → Articles
3. Paramètres → Types de bloc
4. Paramètres → Types

Dans le backoffice, vérifiez que vous pouvez accéder à :

Si toutes ces sections sont accessibles, l'installation est correcte.

Dans le backoffice :

1. Allez dans Paramètres → Langues
2. Activez Français (fr)
3. Activez English (en)
4. Définissez le français comme langue par défaut

Activation rapide via SQL :

    UPDATE languages SET active = 1 WHERE id IN ('fr', 'en');
UPDATE languages SET active = 0 WHERE id NOT IN ('fr', 'en');
    

Créez le dossier pour les templates d'administration personnalisés :

    mkdir -p common/admin
    

Ce dossier contiendra les templates d'admin pour les BlocTypes (Hero, CTA, Card).

Après installation, votre projet devrait avoir cette structure minimale :

    mon-projet/
├── common/
│   ├── config/
│   └── admin/              # Templates d'admin (à créer)
├── webapp/
│   ├── config/
│   ├── controllers/
│   ├── models/
│   ├── views/
│   └── web/
│       └── index.php
└── composer.json
    

Problème : La commande migrate échoue

1. Vérifiez la configuration de base de données
2. Assurez-vous que la base existe et que l'utilisateur a les droits nécessaires
3. Vérifiez que PHP a l'extension MySQL/PDO activée

Solutions :

Problème : La page /bo retourne une erreur 404

1. Vérifiez que le module bo est bien configuré
2. Vérifiez la configuration du serveur web
3. Videz le cache : php yii.php cache/flush-all

Solutions :

Problème : La commande bc:init retourne "Unknown command"

1. Vérifiez que blackcube/core est bien installé via Composer
2. Vérifiez que le module blackcube est configuré
3. Exécutez composer dump-autoload

Solutions :

1. Blackcube installé via Composer
2. Modules configurés dans la config webapp
3. Migrations exécutées
4. Accès au back-office fonctionnel
5. Langues FR/EN activées
6. Dossier common/admin créé

Avant de continuer :