Skip to content

Local development environment for CreativeCommons.org (product name: index)

License

Notifications You must be signed in to change notification settings

creativecommons/index-dev-env

Repository files navigation

index-dev-env

Local development environment for CreativeCommons.org (product name: index).

Overview

This repository has the configuration required to run the CreativeCommons.org website in a local Docker development environment.

The CreativeCommons.org website is comprised of five components that are split into two categories:

  • dynamic component:
    • WordPress (Vocabulary Theme)
  • static components:
    • Chooser
    • FAQ
    • Legal Tools (licenses and public domain)
    • Platform Toolkit

Component repositories

Path label Path Component name Component repositories
Chooser /choose Chooser chooser
FAQ /faq FAQ faq
Licenses /licenses CC Legal Tools cc-legal-tools-app, cc-legal-tools-data
Platform Toolkit /platform/toolkit Platform Toolkit mp
Public Domain /publicdomain CC Legal Tools cc-legal-tools-app, cc-legal-tools-data
WordPress / (default) Vocabulary Theme vocabulary-theme

Code of conduct

CODE_OF_CONDUCT.md:

The Creative Commons team is committed to fostering a welcoming community. This project and all other Creative Commons open source projects are governed by our Code of Conduct. Please report unacceptable behavior to conduct@creativecommons.org per our reporting guidelines.

Contributing

See CONTRIBUTING.md.

Docker containers

The docker-compose.yml file defines the following containers:

  1. index-db - Database server for WordPress
  2. index-phpmyadmin - Database administration
  3. index-web - Web server (WordPress and static HTML components)

Setup

  1. Ensure the following repositories are cloned adjacent to this repository:
    PARENT_DIR
    ├── cc-legal-tools-data
    ├── chooser
    ├── dev-index-env
    ├── faq
    └── mp
    
  2. Create the .env file:
    cp .env.example .env
  3. Update .env to set desired values for variables (WP_VERSION, WP_MOD_TYPE, WP_MOD_NAME, etc.)
  4. Build/start Docker:
    docker compose up
  5. Wait for build and initialization to complete
  6. Setup WordPress:
    ./setup-wordpress.sh
  7. Optional (CC staff only): import production data
    1. Ensure you have access to the production server and your local machine is properly configured to access it
    2. Pull production data
      ./staff_migrate.sh pull
    3. Import production data
      ./staff_migrate.sh import

Path URLs

Path label Dev link Stage link Prod link
Chooser Dev /choose Stage /choose Prod /choose
FAQ Dev /faq Stage /faq Prod /faq
Licenses Dev /licenses Stage /licenses Prod /licenses
Platform Toolkit Dev /platform/toolkit Stage /platform/toolkit Prod /platform/toolkit
Public Domain Dev /publicdomain Stage /publicdomain Prod /publicdomain
WordPress Dev / (default) Stage / (default) Prod / (default)
WordPress Admin Dev /wp-admin Stage /wp-admin Prod /wp-admin

Dev configuration

Apache2

See config/web-sites-available/000-default.conf.

WordPress core

Name Version
WordPress 6.3.1

Also see .env.example.

WordPress plugins

Name Version
Advanced Custom Fields 6.2.1
Advanced Custom Fields: Menu Chooser 1.1.0
Classic Editor 1.6.3
Monster Insights Google Analytics 8.19
Redirection 5.3.10
Tablepress 2.1.7
Wordfence 7.10.4
WordPress Importer 0.8.1
Yoast SEO 21.2

Also see config/composer/composer.json.

WordPress themes

Name Version
Vocabulary Theme 1.5

Also see config/composer/composer.json.

Stage and Prod configuration

The staging server and production server are configured via Salt managed in the creativecommons/sre-salt-prime repository. The list below include the specifics (is non-exhaustive):

Copying

CC0 1.0 Universal (CC0 1.0) Public Domain Dedication button

COPYING: All the content within this repository is dedicated to the public domain under the CC0 1.0 Universal (CC0 1.0) Public Domain Dedication.

About

Local development environment for CreativeCommons.org (product name: index)

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks