What is the Genesis Clip?
The Genesis Clip is a plugin-activated directory of custom files which can be used to safely customize Genesis child themes and plugins. The activation plugin, WP Clips for Genesis, is the simplest of all WP Clips plugins. At a starter size of just 6 kilobytes, it has no WordPress admin settings and is installed as a must-use (mu-) plugin for total protection.
Protection from Genesis child theme updates
Clips are maintained in an isolated plugin directory, ensuring your code customizations are completely protected from all theme and plugin updates.
Simple to install and even simpler to use
It takes less than a minute to install and setup the plugin. You can then start adding your customizations to the core and Genesis Clip's custom files.
Add customizations to core or enable only if declared themes are active
The plugin installs a core Clip for WordPress core functions and a Genesis Clip which can be set to activate only if vital themes/plugins are active.
Easily upgrade to enable multisite and ClipBank™ precoded Clips
Upgrade to WP Clips or WP Clips Multisite to include admin settings, Genesis precoded Clips or to add multisite features and functionality.
Include your custom translations
The plugin comes with a translatable POT file. Simply update the file with your preferred translation plugin to include your customizations!
Simple to back-up, copy and transfer
WP Clips for Genesis doesn't rely on a database, so no exports or imports are required. Just copy the plugin folder or individual Clips to back-up or transfer.
It's as Easy as ...
Install the Plugin
Download WP Clips for Genesis. Unzip the file and upload the folder contents (not the folder) to a new or existing /wp-content/mu-plugins/ directory.
Setup the Clips
Login to WordPress admin to auto-install the Clip folders (no further action is required).
Add compatible themes and required plugins to the Genesis Clip's vitals.php file (refer to FAQ's below for instructions).
Add core-related custom code (PHP) to the core Clip folder's custom file /clip_core/...
Add theme-related custom code (PHP, CSS and JS) to the Genesis Clip folder's custom files /clip_genesis/...
Frequently Asked Questions
Below are answers to frequently asked questions about WP Clips for Genesis. If you have a query, please contact us and we will respond as soon as possible.
I'm already using WP Clips. Do I need to change versions if I'm using Genesis?
No. However, you should update to WP Clips V2 and declare your compatible Genesis child theme in the new custom Clip vitals file.
Note: Changing versions from WP Clips to WP Clips for Genesis is not recommended.
Can I do a standard install of the plugin via WordPress admin?
Yes! But, it can then be deleted via admin.
A standard installation is useful for troubleshooting, as custom code can easily be activated and deactivated. However, when development is complete, transfer the plugin contents to a must-use (mu-) installation for best protection.
Where is the settings page located in WordPress admin?
There is NO settings or option page available with WP Clips for Genesis.
Upgrade to WP Clips Plus or WP Clips Multisite to add admin options for updates/upgrades, and settings for Clip management (activation, unclipping and deletion).
Why can't I see the Clip folders in the unzipped plugin?
The plugin contains the Clip templates. However, the actual Clip folders are installed only when a user is logged into WordPress admin.
How do I declare compatible themes and/or required plugins in the Genesis Clip?
Open the /clip_genesis/vitals.php file.
Add compatible themes to the $themes array using the folder name (e.g 'child-theme-folder-name').
Add required plugins to the $plugins array using the folder name followed by the plugin’s filename (e.g. 'plugin-folder-name/plugin-filename').
Array values are comma-separated.
What if I want to edit a native file in a theme or plugin directory?
A log.txt file is included within the Genesis Clip to record any such changes. When updating the file or plugin, simply refer to your notes to re-apply your edits.
Can I include translatable text in my customizations?
Yes. A POT file is included in the plugin's /languages/ folder. Simply update this file using your preferred translation plugin. Note that WP Clips uses the wp-clips text domain.
How can I install ClipBank™ Precoded Clips?
You will need to upgrade to WP Clips or WP Clips Multisite.
Is the plugin compatible with multisite?
No. You will need to upgrade to WP Clips Multisite.
How do I update or upgrade the plugin?
Simply add or replace only those files/folders included in the NEW plugin folder. Always back-up before proceeding and DO NOT DELETE the Clip folders as this will delete your customizations.
Note: You will need to update the new POT file if you wish to include your custom translatable text.
If your customizations fail to load, visit the WordPress admin area and look for error notices. Click the related notice below for recommended actions.
WP Clips for Genesis failed to load the Genesis Clip because the Genesis framework is not active.
Either activate the Genesis framework or, if you are not using Genesis, upgrade to WP Clips.
WP Clips for Genesis failed to load the Genesis Clip because vital themes/plugins are not active.
Open the /clip_genesis/vitals.php file and check your compatible themes and required plugins declarations. Either alter the declarations or review your active themes and plugins.
Note: If you have switched child themes, make a copy of the /clip_genesis/ folder for your archives and then remove it from the plugin. A new Genesis Clip folder will automatically be installed for your new theme.
WP Clips for Genesis is not compatible with multisite.
Upgrade to WP Clips Multisite.
No error notice.
The issue is most likely related to your code.
For more information on the WP Clips or WP Clips Multisite plugins, including helpful tips on customizing using Clips, please visit http://wpclips.net