WordPress - Full Site Editing, FSE

A modern and secure WordPress project that uses Docker to simplify development and deployment. This project includes optimized configurations for both production and local development.

🚀 Technologies Used

• WordPress - Content Management System
• Docker & Docker Compose - Containerization and orchestration
• MySQL - Database
• PHP - Backend programming language
• Composer - PHP dependency manager
• Akismet - Anti-spam plugin
• JWT Authentication - Secure authentication for REST API
• vlucas/phpdotenv - Environment variable management

📁 Project Structure

wordpress/
├── 📄 composer.json              # PHP dependencies
├── 📄 composer.lock              # Locked PHP dependencies
├── 📄 docker-compose.yml         # Docker services configuration (port 9000)
├── 📄 Dockerfile                 # WordPress container configuration
├── 📄 .dockerignore              # Docker ignore rules
├── 📄 deploy.yml                 # Deployment configuration
├── 📄 environment.php            # Environment configuration
├── 📄 .gitignore                 # Git ignore rules
├── 📄 .htaccess                  # Apache configuration
├── 📄 wp-config.php              # WordPress configuration
├── 📄 wp-config-sample.php       # Sample WordPress configuration
├── 📄 index.php                  # WordPress entry point
├── 📄 wp-*.php                   # WordPress core files
├── 📄 xmlrpc.php                 # XML-RPC endpoint
├── 📄 scripts/
│   ├── 📄 start.sh              # Startup script
│   └── 📄 check-ports.sh        # Port conflict checker
├── 📁 logs/                      # Application logs
├── 📁 mysql/
│   └── 📁 init/
│       └── 📄 01-init.sql       # DB initialization script
├── 📁 vendor/                    # Composer dependencies
├── 📁 wp-admin/                  # WordPress admin panel
├── 📁 wp-content/                # Custom content
│   ├── 📁 plugins/              # Installed plugins
│   │   ├── akismet/             # Anti-spam plugin
│   │   ├── hello.php            # Hello Dolly plugin
│   │   ├── jwt-authentication-for-wp-rest-api/  # JWT authentication
│   │   ├── secure-custom-fields/ # Secure custom fields
│   │   └── woocommerce/         # E-commerce plugin
│   ├── 📁 themes/               # Custom themes
│   │   ├── classic-core-theme/  # Classic core theme
│   │   ├── core-theme/          # Core theme (parent)
│   │   ├── core-theme-child/    # Core theme child (FSE ready)
│   │   └── index.php            # Theme index
│   ├── 📁 languages/            # Translation files
│   ├── 📁 uploads/              # Media files
│   └── 📁 cache/                # Cache files
├── 📁 wp-includes/               # WordPress core files
└── 📄 README.md                  # This file

🔧 Access Port: The project is configured to run on port 9000 (http://localhost:9000)

🛠️ Onboarding - Getting Started

Prerequisites

Before you begin, make sure you have installed:

• Docker (version 20.10+)
• Docker Compose (version 2.0+)
• Git
• Composer (optional, for local development)

2. Configure Environment Variables

Create a .env file at the project root:

cp .env.example .env

Edit the .env file with your settings:

# Database Configuration
WORDPRESS_DB_HOST=mysql
WORDPRESS_DB_USER=wordpress
WORDPRESS_DB_PASSWORD=wordpress_password
WORDPRESS_DB_NAME=wordpress

# WordPress Configuration
WORDPRESS_DEBUG=true
WORDPRESS_CONFIG_EXTRA=

# JWT Configuration
JWT_AUTH_SECRET_KEY=your_very_long_and_secure_secret_key

# FTP Configuration (for deployment)
FTP_SERVER=your_ftp_server
FTP_USERNAME=your_ftp_user
FTP_PASSWORD=your_ftp_password
DEPLOY_DIR=/path/on/server

3. Start the Project with Docker

Option A: Using Docker Compose (Recommended)

# Build and start all services
docker-compose up -d

# View logs in real time
docker-compose logs -f

# Stop the services
docker-compose down

Option B: Using the Startup Script

# Give execution permissions to the script
chmod +x scripts/start.sh

# Run the startup script
./scripts/start.sh

4. Access the Application

Once the containers are running:

🔓 HTTP Access (Recommended for development)

• WordPress Frontend: http://localhost:9000
• WordPress Admin: http://localhost:9000/wp-admin
• phpMyAdmin: http://localhost:8081

🔒 HTTPS Access (Optional)

If you need HTTPS for development:

# 1. Generate SSL certificates
./scripts/generate-ssl.sh

# 2. Start with SSL
docker-compose -f docker-compose.yml -f docker-compose.ssl.yml up -d

# 3. Access with HTTPS
- **WordPress Frontend**: https://localhost
- **WordPress Admin**: https://localhost/wp-admin

⚠️ Note: For local HTTPS, you will need to configure the certificate in your browser or use special flags.

5. Initial WordPress Setup

1. Go to http://localhost:9000
2. Select your language
3. Complete the site information:
   • Site title
   • Admin user
   • Password
   • Email
4. Click "Install WordPress"

🔧 Useful Commands

Docker Compose

# Check the status of services
docker-compose ps

# Rebuild containers
docker-compose up -d --build

# Run commands inside the container
docker-compose exec wordpress wp --info

# View logs for a specific service
docker-compose logs wordpress

# Stop and remove containers
docker-compose down -v

WordPress CLI

# View WordPress information
docker-compose exec wordpress wp --info

# List plugins
docker-compose exec wordpress wp plugin list

# Activate plugin
docker-compose exec wordpress wp plugin activate plugin-name

# Update WordPress
docker-compose exec wordpress wp core update

Database

# Access MySQL
docker-compose exec mysql mysql -u wordpress -p wordpress

# Backup the database
docker-compose exec mysql mysqldump -u wordpress -p wordpress > backup.sql

# Restore backup
docker-compose exec -T mysql mysql -u wordpress -p wordpress < backup.sql

🚀 Deployment

Deployment with Docker

To deploy to production: