Hero is a library that allows you easily create Models to your WordPress theme or plugin and interact with them through a simple and beautiful API.

composer require alterfw/hero

Require the composer autoload file into your functions.php:

require "vendor/autoload.php";

And Hero will be ready!

You can read more about how Ampersand works in the documentation page.

This project doesn't have an styleguide yet but you should follow the existing code. Before create any pull requests make sure that all tests are passing.

To setup de development environment first download Docker and create a virtual machine:

docker-machine create --driver virtualbox default
eval "$(docker-machine env default)"

Then run:

docker-compose up

This will create a WordPress and a theme with Hero installed as dependency.

If you want to modify the theme files, take a look at the test/fixtures directory. These files are copied during the docker-compose up command, so if you change anything in these files you need to terminate the process and run again.