Skip to content

README.md

Latest commit

 

History

History
181 lines (133 loc) · 5.03 KB

README.md

File metadata and controls

181 lines (133 loc) · 5.03 KB

WordPress Boilerplate — WooCommerce

Boilerplate WordPress avec architecture Bedrock, gestion des dépendances via Composer, templating Timber/Twig et stack front-end moderne (Vite + SCSS).

Stack technique

Couche Technologie
CMS WordPress (via roots/wordpress)
Architecture Bedrock
Dépendances PHP Composer
Templating Timber / Twig
Build front-end Vite
CSS SCSS → LightningCSS + Autoprefixer + PurgeCSS
JS ES Modules natifs
CLI WordPress WP-CLI

Prérequis

Installation

1. Cloner le dépôt et installer les dépendances PHP

git clone <repo-url> && cd wordpress-boilerplate-woocommerce
composer install

2. Configurer l'environnement

cp .env.example .env

Renseigner les variables dans .env :

DB_NAME=your_db
DB_USER=your_user
DB_PASSWORD=your_password
DB_HOST=localhost

WP_ENV=development
WP_HOME=http://localhost:8080
WP_SITEURL=${WP_HOME}/wp

3. Installer les dépendances front-end

cd web/app/themes/default
npm install

Lancer le projet

Serveur PHP intégré

Depuis la racine du projet :

php -S localhost:8000 -t web

Ou via WP-CLI (utilise la config wp-cli.yml) :

wp server

WordPress est accessible sur http://localhost:8080 L'admin est sur http://localhost:8080/wp/wp-admin

Serveur de développement Vite

Dans web/app/themes/default/ :

npm run dev

Vite démarre sur http://localhost:1337 avec hot-reload sur les fichiers .php et .twig.

Build de production

npm run build

Les assets compilés sont générés dans web/app/themes/default/dist/.

Plugins inclus

Plugin Description
WooCommerce E-commerce
WooCommerce Gateway Stripe Paiement Stripe
Secure Custom Fields (SCF/ACF) Champs personnalisés
Extended CPTs Custom post types simplifiés
Extended ACF API orientée objet pour ACF
Query Monitor Débogage (dev)
Bedrock Autoloader Autoload mu-plugins
Bedrock Disallow Indexing Bloque l'indexation hors production

Librairies PHP complémentaires

Package Description
Timber Templating Twig pour WordPress
Extended Template Parts Template parts avancés
johnbillion/args Arguments typés pour WP
vinkla/headache Nettoyage du front WordPress

Structure du projet

├── composer.json
├── config/
│   ├── application.php         # Config WordPress principale
│   └── environments/           # Surcharges dev / staging / production
├── web/
│   ├── app/
│   │   ├── mu-plugins/         # Must-use plugins
│   │   ├── plugins/            # Plugins Composer
│   │   ├── themes/
│   │   │   └── default/        # Thème principal
│   │   │       ├── assets/
│   │   │       │   ├── js/
│   │   │       │   └── scss/
│   │   │       ├── views/      # Templates Twig
│   │   │       ├── src/        # Classes PHP du thème (PSR-4 Theme\)
│   │   │       ├── vite.config.js
│   │   │       └── package.json
│   │   └── uploads/
│   ├── wp/                     # Core WordPress (géré par Composer)
│   └── index.php
└── wp-cli.yml

WP-CLI

Le fichier wp-cli.yml pointe automatiquement vers web/wp. Toutes les commandes WP-CLI peuvent donc être lancées depuis la racine :

wp plugin list
wp user create admin admin@example.com --role=administrator
wp search-replace 'http://old-url.com' 'http://localhost:8000'

Documentation