# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

This is a WordPress multisite installation for the ENMI Conference website (enmi-conf.org) running in a containerized environment. The project uses Docker Compose with Caddy as a web server, MariaDB for the database, and PHP-FPM for processing.

## Architecture

- **`wp/`**: Primary WordPress installation (production-like)
- **`wordpress/`**: Secondary WordPress installation (backup/staging)
- **`enmi12/`**: Legacy conference materials from 2012
  - `freemind/`: Mind mapping files
  - `glossaire/`: Glossary with graph visualization
- **Docker services**:
  - `web`: Caddy server (port 8080)
  - `fpm`: PHP-FPM container
  - `db`: MariaDB database
  - `wpcli`: WordPress CLI (dev profile only)

## Development Environment

The project uses Nix for development dependencies and direnv for environment management.

### Prerequisites
- Docker and Docker Compose (or Podman Compose)
- Nix (optional, for development shell)

### Development Setup

1. **Start the environment:**
   ```bash
   docker compose pull
   docker compose build
   docker compose up -d
   ```

2. **Access the site:**
   - Local URL: http://enmi-conf.127.0.0.1.nip.io:8080

### Database Operations

**Import database backup:**
```bash
zcat ../dev/enmi-conf_db_export_2022-09-21.sql.gz | docker compose --profile=dev run -T -w "/var/www/html/wp" wpcli wp db cli
```

**Update URLs for local development:**
```bash
# Test URL replacement (dry run)
docker compose --profile=dev run -w "/var/www/html/wp" wpcli wp search-replace --dry-run --network "enmi-conf.org" "enmi-conf.local:8080"

# Update blog domains
echo "update wp_blogs set domain='enmi-conf.local:8080';" | docker compose --profile=dev run -T -w "/var/www/html/wp" wpcli wp db cli

# Update home and siteurl options for all sites
echo "select path from wp_blogs;" | docker compose --profile=dev run -T -w "/var/www/html/wp" wpcli wp db cli --skip-column-names | xargs -I % docker compose --profile=dev run -T -w "/var/www/html/wp" wpcli wp --url="http://enmi-conf.local:8080%" option update home "http://enmi-conf.local:8080%/"

echo "select path from wp_blogs;" | docker compose --profile=dev run -T -w "/var/www/html/wp" wpcli wp db cli --skip-column-names | xargs -I % docker compose --profile=dev run -T -w "/var/www/html/wp" wpcli wp --url="http://enmi-conf.local:8080%" option update siteurl "http://enmi-conf.local:8080%/"

# Update database schema
docker compose --profile=dev run -w "/var/www/html/wp" wpcli wp core update-db --network
```

### WordPress CLI Operations

All WP-CLI commands should be run in the `/var/www/html/wp` directory:
```bash
docker compose --profile=dev run -w "/var/www/html/wp" wpcli wp [command]
```

### File Synchronization

**Sync uploads from production:**
```bash
rsync -avz -h --stats -P charlie.iri.centrepompidou.fr:/shared/php-01/enmi-conf.org/wp/wp-content/uploads/ ./
```

**Sync WordPress core files (dry-run first):**
```bash
rsync -arvz --delete --dry-run --exclude wp-content --exclude wp-config.php ./wordpress/ ./wp/
```

## WordPress Configuration

- **Database**: `wordpress_ec`
- **DB User**: `iri`
- **Themes**: IN-MOTION-package-u1 (parent), IN-MOTION-package-u1-child
- **Key Plugins**: 
  - portfolio
  - include-mastodon-feed
  - blog-copier
  - option-tree

## Important Files

- `docker-compose.yml`: Container orchestration
- `Caddyfile`: Web server configuration
- `wp-config.php`: WordPress configuration (root level)
- `wp/wp-config.php`: Site-specific WordPress config
- `fpm.Dockerfile`: PHP-FPM container build
- `Readme`: Setup and maintenance commands

## Version Control (Mercurial)

This project uses Mercurial (hg) for version control.

**Add files to tracking:**
```bash
hg add [file]
```

**Remove files from tracking:**
```bash
hg remove [file]
# or to remove from tracking but keep file:
hg forget [file]
```

**Add new files and remove deleted files automatically:**
```bash
hg addremove
```

**Check repository status:**
```bash
hg status
```

## Alternative with Podman

For systems using Podman instead of Docker, replace `docker compose` with `podman-compose` and use the nip.io domain format:
```bash
podman-compose --profile=dev run -w "/var/www/html/wp" wpcli wp search-replace --network "enmi-conf.org" "enmi-conf.127.0.0.1.nip.io:8080"
```