SPARCpress

A mo'better workflow

Automagic Install

1. Open Terminal and cd the SPARCpress directory
2. Start the virtual machine 
	1. Vagrant up
3. SSH 
	1. Vagrant ssh
4. Deploy
	1. cd /vagrant && bash helpers/deploy.sh
5. Open your favorite flavor of web browser and navigate to 10.0.0.10
6. Complete the WordPress famous 5 minute install		

Configurations

Copy

Grunt-copy moves dependencies from bower_components to the proper WordPress directory e.g., core, pluings, and themes. If you plan to add or modify Bower dependencies, make sure to update the copy task.

WordPress

SPARCpress ships with a loose WordPress configuration. If you plan to use SPARCpress outside a development environment you must tighten the configuration. The configuration settings are found in gruntfile.

Pushing

SFTP

SPARCpress uses a sftp-deploy task for code deployment over the sftp protocol. Before deploy you need to update the sftp-deploy configuration in your grunt file and add .ftppass file at the root of the project. The .ftppass will be omitted from source control.

Usernames, passwords, and private key references are stored as a JSON object either in a file named .ftppass. Please update the .ftppass file with your username and password.

{
  "key1": {
    "username": "username1",
    "password": "password1"
  },
  "key2": {
    "username": "username2",
    "password": "password2"
  },
  "privateKey": {
    "username": "username"
  },
  "privateKeyEncrypted": {
    "username": "username",
    "passphrase": "passphrase1"
  },
  "privateKeyCustom": {
    "username": "username",
    "passphrase": "passphrase1",
    "keyLocation": "/full/path/to/key"
  },
  "privateKeyCustomByFileName": {
    "username": "username",
    "passphrase": "passphrase2",
    "keyLocation": "filename-of-key"
  },
  "sshAgentSocket": {
    "username": "username",
    "agent": true
  },
  "pageant": {
    "username": "username",
    "agent": "pageant"
  }
}

To deploy to SFTP server:

1. Open Terminal and cd the SPARCpress directory
2. $ vagrant ssh
3. $ grunt sftp-deploy

By design the following default WordPress Theme(s) are part of the exclusions array: * wordpress/wp-content/themes/twentyfourteen/* * wordpress/wp-content/themes/twentythirteen/* * wordpress/wp-content/themes/twentytwelve/* * wordpress/wp-content/themes/twentyeleven/* * wordpress/wp-content/themes/twentyten/*

FTP

TBD

Vagrant

SPARCpress utilizes Vagrant to manage dependencies. Make sure you have Vagrant and Virtualbox installed on your machine.

###Helpful Vagrant Commands 1. Start a Vagrant box 1. vagrant up 2. Stop a Vagrant box 1. vagrant halt 2. Remove a Vagrant box 1.Vagrant destroy More Vagrant goodness...