Skip to content

INN/umbrella-ffj

Repository files navigation

Why is the child theme directory named sirf?

This site was originally named SIRF (Southern Investigative Reporting Foundation), but has since been changed to FFJ (The Foundation for Financial Journalism). All user facing names for the child theme have been updated to FFJ, but changing the actual child theme directory name would cause issues detailed here: #12 (comment)

Setup instructions

This repository is designed to be set up in accordance with the VVV install instructions in INN/docs, that were introduced with INN/docs#148

To get started, open a new terminal window.

Navigate to the vagrant-local/www directory.

And then run:

vv create

You'll then see a series of prompts. Respond thusly:

Prompt Text to enter
Name of new site directory: ffj
Blueprint to use (leave blank for none or use largo): largo
Domain to use (leave blank for largo-umbrella.dev): ffj.dev
WordPress version to install (leave blank for latest version or trunk for trunk/nightly version): hit [Enter]
Install as multisite? (y/N): n
Git repo to clone as wp-content (leave blank to skip): hit [Enter]
Local SQL file to import for database (leave blank to skip): This directory must be an absolute path, so the easiest thing to do on a Mac is to drag your mysql file into your terminal window here: the absolute filepath with fill itself in.
Remove default themes and plugins? (y/N): y
Add sample content to site (y/N): N
Enable WP_DEBUG and WP_DEBUG_LOG (y/N): N

After reviewing the options and creating the new install (you'll be prompted part way through the install process to provide your admin password), proceed with the following steps:

  1. cd to the directory ffj/ in your VVV setup
  2. git clone [email protected]:INN/umbrella-ffj.git
  3. Copy the contents of the new directory umbrella-ffj/ into htdocs/, including all hidden files whose names start with . periods.
    • the easy way to do this is: rsync -rv umbrella-ffj/ htdocs
  4. cd htdocs to move to the folder where the umbrella now lives
  5. git submodule update --init to pull down all of the submodules you need (including, crucially, the tools repo)
  6. workon fabric
  7. fab production wp.fetch_sql_dump (or download via FTP if this doesn't work)
  8. fab vagrant.reload_db:mysql.sql
  9. Search and replace 'ffj.wpengine.com' --> 'ffj.dev' in the db (options for doing this are covered in the largo umbrella setup instructions
  10. Optionally, you may want to pull down recent uploads so you have images, etc. to work with locally.
  11. Visit ffj.dev in your browser and you should see the site!