A react-based theme for WordPress.
Since this is a more "experimental" theme, you'll need to have a few things set up before it'll work.
- WordPress 4.7 or higher, which includes the REST API content endpoints.
- You'll also need this WP-API Menus plugin. The REST API doesn't provide an endpoint for menus, so another plugin is necessary.
- Your permalinks will need to be set to
/%year%/%monthnum%/%postname%/. Single-post/page views will not work without permalinks set. Category & tag archives bases should be set to
- WordPress 4.7+
- PHP 5.4+
- If building locally, Node 8.9.1 + npm 5.5.1
Display & Features
This theme supports your average blogging site. It looks best with "Front page displays" set to latest posts (in Settings > Reading), however it does support a static page & blog posts on another page. This theme works best for very text-focused sites. It will display featured images on single posts & pages, but not on archive/list views. There is currently no special handling for post formats.
This theme does have a few "restrictions", things that don't work like they do in other WordPress themes.
The API cannot be blocked by a security plugin. Some plugins recommend blocking the users endpoint, but that is required to show the author archive. If you need to block the user endpoint, the rest of the theme should work, but might be unstable if anyone tries to visit an author archive.
Permalinks for pages and archives are changed by this theme. They'll be reset if/when you deactivate the theme. You might want to set up redirects using something like Safe Redirect Manager.
This theme does not support hierarchical category archives - only parent category archive pages can be displayed. This may be fixed in a later version of the theme (see #30).
Plugins might not work as expected, especially if they add content to the front end of your site. Most Jetpack features do still work.
If you're logged in to your site, the admin bar will currently not update when you navigate pages, so the "Edit X" link will only reflect the page you initially loaded. You can force-reload the page to update the admin bar, as a work-around.
These are a few of the packages/plugins that made this theme possible.
- WP API Menus Plugin
- & of course, Mel Choyce for designing all the things.
You can also install Foxhound yourself from this repo, by building it yourself. Download or clone this repo into your
git clone https://github.com/ryelle/Foxhound foxhound cd foxhound npm install npm run build
Now you'll see a
build/app.js file in the theme, and it will be available for you to switch to in wp-admin. If you're having trouble getting the theme active, please file an issue & I'll help you out.
If you don't have npm installed, you can find instructions on the npm website.
There are a few other NPM scripts you can run:
npm run dev runs
webpack, with configuration enabling source maps. Eventually
build will also compress/uglify built files, so this would skip that too (but that's currently disabled).
npm run watch runs
webpack --watch, everything the previous command but it will also watch the source files for changes and recompile automatically. Best to run while developing. This does not live reload.
npm run lint runs
On the PHP side, we're also adding in some prefixes for permalinks (also called routes).
If you notice anything broken (that isn't mentioned in the "restrictions" section), let me know by creating an issue.
Thanks for checking out Foxhound!