WordPress options framework which uses the WordPress Settings API, Custom Error/Validation Handling, Custom Field/Validation Types, and import/export functionality.
Posting Guidelines for issues and questions
When using our Issue Tracker, you may ask questions where you may be a bit lost or need help understanding the documentation. If, however, you find a bug we require you to read and provide the information contained in our Contributing Guidelines. If you do not provide this information, we will request it before we can support you.
If you are stuck in some of your own code, or need help with PHP and anything else not Redux specific, we request you purchase some Premium Support and we will be happy to assist you. If we feel the issue is outside of our scope we will suggest you to purchase some Premium Support in order for us to serve you.
Kickstart Your Development
Are you authoring a theme, or plugin? Visit the Redux Builder site and get started!
Demo Your Products
We help you create a seamless user experience for your users to demo your WordPress products. Not only that, we help you make sure they’re engaged, turning them into a potential customer. Visit wpdemo.io/
Documentation
Need a little help with Redux? Come check out our brand new documentation site at docs.reduxframework.com, chock full of tutorials and examples!
SMOF (Simple Modified Option Users) Converter!
Hot off the press, our Redux Converter plugin. It takes your SMOF instance, and allows you to try out Redux without any fear. It also spits out valid PHP source for you if you want to migrate complete with data migration! Give it a try today. It will be in the WordPress.org repo shortly. ;) https://github.com/ReduxFramework/redux-converter
Help Us Translate Redux
Please head over to the wiki to learn how you can help us translate Redux quickly. Any and all are welcome. We appreciate your help! https://github.com/ReduxFramework/ReduxFramework/wiki/translate
Getting Started with Redux
ReduxFramework has been built from the ground up to be the most flexible framework around. You can run it as an auto-updating plugin, or embed it inside your plugin or theme. It allows for multiple copies of itself within the same WordPress instance. For a guide on getting started please refer to https://github.com/ReduxFramework/redux-framework/wiki/Getting-Started.
You can also download our sample theme available here to start developing right away.
Please Post Reviews and Spread the Word
ReduxFramework has just released to the WordPress Plugins directory. Please spread the word, tweet, and (most importantly) post reviews on http://wordpress.org/plugins/redux-framework/.
Donate to the Framework
If you can, please donate to help support the ongoing development of Redux Framework!
Features
- Uses the WordPress Settings API
- Multiple built in field types
- Multple layout field types
- Fields can be overloaded with a callback function, for custom field types
- Easily extendable by creating Field Classes
- Built in Validation Classes
- Easily extendable by creating Validation Classes
- Custom Validation error handling, including error counts for each section, and custom styling for error fields
- Custom Validation warning handling, including warning counts for each section, and custom styling for warning fields
- Multiple Hook Points for customisation
- Import / Export Functionality - including cross site importing of settings
- Easily add page help through the class
- Fully responsive options panel
- Much more
Stay In The Loop!
FAQs
- Why should we use
require_once
instead ofget_template_part
?
- First, because
get_template_part
is for... you guessed it, themes! Redux is designed to work with both themes and plugins. - Second, read this.
- Why shouldn't we edit
sample-config.php
in the plugin directory?
- Because
sample-config.php
will be replaced at each update of the plugin. You will lose all your effort
Are you using Redux?
Send us an email at info@reduxframework.com so we can add you to our showcase!
Changelog
See Changelog.md
Running PHP Unit tests
The tests are built using wordpress's make subversion repository
/var/www/wordpress-develop
as the destination for the core test files.
First download the wordress core tests repository, for these files.
cd /var/www
svn co http://develop.svn.wordpress.org/trunk/ wordpress-develop
In the newly created /var/www/wordpress-develop
directory rename
wp-tests-config-sample.php
to wp-tests-config.php
. Now add your database
details to the new file:
// WARNING WARNING WARNING!
// These tests will DROP ALL TABLES in the database with the prefix named below.
// DO NOT use a production database or one that is shared with something else.
define( 'DB_NAME', 'wordpress-tests' );
define( 'DB_USER', 'root' );
define( 'DB_PASSWORD', 'passowrd' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );
- n.b. you may need to create the database first.
- n.b. n.b. also note that the database used will be emptied on each run.
Set the WP_TESTS_DIR
environment variable so that the redux-framework
test bootstrap file can find the wordpress core tests:
export WP_TESTS_DIR='/var/www/wordpress-develop/tests/phpunit/includes/'
You should now be able to run the redux-framework
unit tests:
redux-framework$ phpunit
Welcome to the TIVWP Test Suite
Version: 1.0
Tests folder: /var/www/wordpress-develop/tests/phpunit/includes/
Installing...
...
Configuration read from
redux-framework/phpunit.xml
...