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 [email protected] 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
   • localhost:8003
3. index-web - Web server (WordPress and static HTML components)
   • localhost:8080

Setup

1. Ensure the following repositories are cloned adjacent to this repository:

   PARENT_DIR
   ├── cc-legal-tools-data
   ├── chooser
   ├── dev-index-env
   ├── faq
   └── mp
   

   • creativecommons/cc-legal-tools-data
   • creativecommons/chooser
   • creativecommons/faq
   • creativecommons/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.14

Also see config/composer/composer.json.

vocabulary-theme QA Checklist

vocabulary-theme release testing QA checklist

1. run setup-wp script (again to make sure WP is current version)
2. be sure to clear/disable caches locally
3. review any new context/template/page
4. review pages:
   • home-page
   • sub-page
   • team-index
   • search-index
   • archive-page
   • blog-index
   • blog-post
   • faq
   • mp
   • licenses list
   • license deed | EN
   • license legal code | EN
   • license deed | AR
   • license legal code | AR

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):

• pillars/
  • 3_HST/index/
  • 5_HST__POD/index__stage
• states/
  • apache2/files/index.conf
  • wordpress/files/index-composer.json
  • wordpress/index.sls

Copying

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.