The S!zzle admin portal
(hosted on AWS)
- production: hermes.gosizzle.io
- development/staging: dev.gosizzle.io
Add (Bacon)[https://github.com/GiveToken/Bacon] to your src
after forking it:
cd src
git clone https://github.com/<your username>/Bacon.git
If you'll be testing AWS, you'll need to create /.aws/credentials
and enter the following:
[sizzle]
aws_access_key_id = AWS_ACCESS_KEY_ID
aws_secret_access_key = AWS_SECRET_ACCESS_KEY
with your specific credentials.
If on a Mac, you can update /etc/apache2/extra/httpd-vhosts.conf
to include something like
<VirtualHost *:80>
ServerAdmin username@gosizzle.io
ServerName hermes.gosizzle.local
DocumentRoot "/Library/Webserver/Documents/Hermes/public"
<Directory "/Library/Webserver/Documents/Hermes/public">
Options -Indexes +FollowSymLinks +MultiViews
AllowOverride All
Require all granted
</Directory>
# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn
</VirtualHost>
and restart Apache. Then modify /etc/hosts
to include
127.0.0.1 hermes.gosizzle.local
Composer is the PHP package manager used to bring in 3rd party PHP code. Once you have it in installed, cd to the project directory and run
composer install
which will create everything you need in the untracked vendor directory.
Bower is a package manager used to bring in Polymer components. Once you have it in installed, cd to the project directory and run
bower install
which will create everything you need in the untracked components directory.
- Fork
- Clone
- Checkout
develop
- Branch
- Code
- Submit Pull Request
Github has a great reference here.
Presuming you have set up Composer, then PHPUnit will be available in your /vendor/bin directory. You'll need to setup your local parameters by
cp src/Tests/local.php.example src/Tests/local.php
and making any necessary changes to local.php
. To run all the tests, just reference the
configuration file:
vendor/bin/phpunit --bootstrap src/tests/autoload.php -c tests.xml
To also investigate the code coverage of the tests, you'll need the
Xdebug PHP extension.
Make sure you put any unit tests in the src/tests
directory and name them like
MyAwesomeTest.php.
For JavaScript testing, run the following command
npm run test
The build script (build.sh
) runs unit tests, warns you of any untracked or
uncommited files, minifies JavaScript & CSS.
The full set of options is available in the help menu
./build.sh -h
The important caveat is that this script was written on OSX and may not work on Cygwin or your favorite Windows version of Linux.
Any push to develop
will one day be automagically pulled onto the staging server except
during the QA period for new releases.
Log into the production webserver and
git branch YYYYMMDD.backup
git pull origin master
composer install