/blog.codecorps.org-site

Bedrock file structure and Sage theme for the Code Corps WordPress blog.

Primary LanguagePHPMIT LicenseMIT

Code Corps WordPress (Bedrock + Sage)

Code Corps Bedrock + Sage Logo

This repository contains the Bedrock file structure and Sage theme for the Code Corps WordPress blog.

Bedrock is a modern WordPress stack that helps you get started with the best development tools and project structure.

Sage is the best WordPress starter theme with a modern front-end development workflow.

Much of the philosophy behind Bedrock is inspired by the Twelve-Factor App methodology including the WordPress specific version.

Features

  • Better folder structure
  • Dependency management with Composer
  • Easy WordPress configuration with environment specific files
  • Environment variables with Dotenv
  • Autoloader for mu-plugins (use regular plugins as mu-plugins)
  • Enhanced security (separated web root and secure passwords with wp-password-bcrypt)

Use Trellis for additional features:

Publicly available:

  • Easy development environments with Vagrant

Privately held, for security:

  • Easy server provisioning with Ansible (Ubuntu 14.04, PHP 5.6 or HHVM, MariaDB)
  • One-command deploys

Requirements

Installation

Clone this repository along with Trellis into the following directory structure:

blog.codecorps.org/      # → Root folder for this project
├── trellis-public/      # → Your clone of the public Trellis repository
├── trellis/             # → Your clone of the private Trellis repository (acccess limited; private for security)
└── site/                # → Your clone of this repository, a Bedrock-based WordPress site
    └── web/
        ├── wp/          # → WordPress core (don't touch!)
        └── app/         # → WordPress content directory (themes, plugins, etc.)
            └── web/themes/codecorps  # → Code Corps theme directory (where most blog dev work will happen)
  1. Create the main project directory (if not already created):
mkdir blog.codecorps.org
cd blog.codecorps.org
  1. Clone Trellis:
git clone git@github.com:code-corps/blog.codecorps.org-trellis-public.git trellis-public
  1. Clone the site:
git clone git@github.com:code-corps/blog.codecorps.org-site.git site
  1. Install the Ansible Galaxy roles:
cd trellis-public && ansible-galaxy install -r requirements.yml
  1. Run locally inside trellis-public. Read those docs for more,

Windows user? Read the Trellis Windows docs for slightly different installation instructions. Please modify them to match these docs. VirtualBox is known to have poor performance in Windows — use VMware or see some possible solutions.

Documentation

Bedrock documentation is available at https://roots.io/bedrock/docs/.

Sage documentation is available at https://roots.io/sage/docs/.

Contributing

Contributions are welcome from everyone. We have contributing guidelines to help you get started.

Community

Join the Code Corps community at https://codecorps.org/code-corps/code-corps