Tango is an experimental WordPress theme that uses the React UI library in conjunction with standard Underscores template files. The goal is to develop a method for adding the magic of JavaScript-based UIs to existing WordPress themes, built in PHP.
Requires the WP API Theming plugin.
- Install and activate the WP REST API plugin . Leave it on the
developbranch. - Install and activate the WP API Theming plugin.
- Clone the Tango repo into your
wp-content/themes/folder:git clone git@github.com:kwight/tango.git cdinto your new Tango theme, and runnpm install.- Run
npm run buildto createstyle.cssandjs/public.js. See Issues below if you getEMFILEerrors. - Activate Tango from
Appearance > Themes.
Tango requires some basic information to be able to properly connect to the API, and generate accurate links. These are set in js/config.js.
api: the API's index, eg.http://localhost/wp-json(required)serverRoot: the root folder of your web server, eg.http://localhost(required)subdir: if your WordPress install is in a subfolder of your web server, enter the relative path here, eg./trunk/srclocalStorage: whether or not to use localStorage for API results (note: there is currently no handling for stale results)
Run npm run watch instead of npm run build while developing, to have files recompile automatically upon save.
Make sure you have compiled style.css and js/public.js (with npm run build or npm run watch) before activating Tango; otherwise, you'll get an error because of the missing required stylesheet.
On OS X, there is a known issue with low limits of open files, which can cause Error: EMFILE errors with Browserify (used by npm run build).
Some users report changing system settings with sudo ulimit -n 2560 can solve it. If it does not, or you prefer not to change a system setting in that way, you can run npm run watch instead to generate js/public.js (but it will not be minified).