Plugins

ClassicPress Integrity Checker
Simone Fioravanti

Check core files against MD5.

Download

More Info
Nofollow Post Links
iljester

Nofollow Post Links is a plugin that allows you to manage the nofollow attribute of post links. You can manage them granularly,

Download

More Info
Description

Nofollow Post Links is a plugin that allows you to manage the nofollow attribute of post links. You can manage them granularly, within the single post, or you can assign nofollow attribute to all links, or again, you can remove the attribute for all links.

Compatibility and support

This plugin was designed specifically for ClassicPress. However, it may also be compatible with WordPress if the classic editor is used. In any case, support is limited to ClassicPress installations only.

Installation
1. Upload plugin in the wp-content > plugins directory.
2. Then, install it.
3. Activate.
Thirdy part assets

Nofollow Post Links uses:
- Update client class from plugin (Update Manager)[https://software.gieffeedizioni.it/plugin/update-manager/], released under GPLv2 license. Author Simone Fioravanti.
- github workflows by Simone Fioravanti https://github.com/xxsimoxx
Frequently Asked Questions

Can I choose the links to which I want to nofollow?

Yes, for each post you can establish which links should have nofollows.
You can also globally determine which domains will not be nofollowed.

Is the nofollow attribution definitive?

Here we must distinguish between attribution of nofollow on a “single content” and attribution of nofollow on “all contents” for every post type in your site:
- Attribution on single content. Here the attribution of nofollow or its removal occurs by modifying the content post unless you have set or left the “Same for the metabox action” option set. In this case, see the next point.
- Global attribution. Global attribution works in three ways: “Javascript”, “Content Filter” and “Content Edit”. If you use the “Javascript” or “Content Filter” mode, the original content of the post is not changed. With the “Content Edit” mode, the plugin will write the content of your post. If you choose the “Content Edit” option, remember to make a backup of your database before proceeding.
What is the purpose of Restore Post Settings?

“Restore post setting” is an action that allows the restoration of the configuration via metabox, before the global action is run. This action is particularly useful if you use the “Content Edit” mode. However, please note that if you save the content of your post after a global action in “content edit” mode, a new backup will be generated with the globally assigned settings.

Should I make a database backup before using Nofollow Post Links?

Generally, it is good practice to make a backup before installing and using a plugin on a live site. In the case of Nofollow Post Links, backup is highly recommended if you use the “Content Edit” mode for global actions. This mode is still experimental, and is highly invasive, because edit the post, and since the plugin has not been sufficiently tested on a sufficient number of installations, it becomes essential to create a backup (at least of the wp_posts and wp_postmeta tables.) before executing it, also because the “Restore post settings” action may not be useful in this case.

What is the best mode for global action?

Please note that the “Javascript” mode and the “Content Filter” mode work in the frontend, therefore, although minimal, they will have an impact on the loading of the page. But if you use a caching system, you won’t even notice.
The “Content Edit” mode has no impact on the frontend, because it only edits the post.
The choice is therefore subjective, without prejudice to what has been said in the previous FAQs.

Wait! When I started a global action the metabox disappeared!

Naturally. If you have activated a global dofollow or nofollow action you cannot edit links via the metabox.

What is nofollow mapping?

Nofollow mapping allows you to retrieve nofollows manually inserted into links and update metabox settings. Very useful especially after installing the plugin.

What is the function of harmonize?

Harmonize allows you to simultaneously assign the nofollow attribute to a specific domain or remove the nofollow attribute. It is a global assignment function which however only acts on a specific domain.

Can I create a domains whitelist?

Yes. Simply enter them in the appropriate field in the settings tab, and the global actions will ignore those domains. Additionally, you won’t be able to assign nofollow via the metabox. However, in content edit mode you can assign it manually (but why would you do that?).

Can I choose the post type for global actions?

Yes. From the settings, you can determine which post types you can perform global actions on. You can also decide in which post types to show the post link metabox.

What happens when the plugin is uninstalled?

Any data in the database referring to the plugin will be removed. If you used content edit mode to assign nofollows, they will remain after uninstallation unless you used “Restore Post Settings” or the “Global Dofollow” action before uninstalling the plugin.
MicroBlog
ElisabettaC77

adds front-end micro blog to ClassicPress

Download

More Info
FX Builder
Ciprian Popescu

FX Builder is an improved page builder plugin for ClassicPress that provides visual columns in the post editor without using shortcodes.

Download

More Info
FX Builder is a page builder plugin that provides visual columns in the post editor without using shortcodes. From the settings page, you can enable it for posts, pages, and custom post types. There is no vendor lock-in.

Features:
1. Super simple to use.
2. Visual columns in the post editor.
3. If you disable the plugin, you content is not lost.
4. Settings to enable/disable for each post type.
5. 1-4 columns supported.
6. Free, Open Source, GPL v3.0 or later license. Use it to make something cool :)
Installation
1. Navigate to “Plugins > Add New” Page from your Admin.
2. To install from plugin .zip file, click “Upload Plugin” button in “Plugins > Add New” Screen. Browse the plugin .zip file, and click “Install Now” button.
3. Activate the plugin.
4. Navigate to “Settings > FX Builder” to configure.
5. Edit your content.
Changelog

= 1.3.0 =
- Remove jQuery UI Sortable dependency and replace with SortableJS
- Remove old, unused files
- Update plugin branding to be consistent with “FX Builder”
= 1.2.2 =
- Fix undefined variable
- Add image styling to wraps to make sure images are not wider than content
- Remove “Wide” content width, as it’s not relevant, and can be added as a class
= 1.2.1 =
- Add font size presets, custom font size and font weigh to TinyMCE
- Clean up row and item templates
- Clean up front-end styles
- Clean up readme.txt
= 1.2.0 =
- First public release for ClassicPress
= 1.0.2 – 13 Ags 2017 =
- Fix bug: WP 4.8 compat (thanks to nick6352683)
= 1.0.1 – 06 Jan 2017 =
- Fix bug: wp preview remove FX Builder data
- Fix CSS Bug: Tools & CSS button position
- Store _fxb_active in revisions
- Hide “Preview Changes” button in “Publish” meta box when FX Builder is active
- Fix “save_post” hook to fix fatal error bug
= 1.0.0 – 09 Dec 2016 =
- First stable Release
= 1.0.0.beta – 12 Oct 2016 =
- Browser compatibility (Tested with: Firefox, Chrome, IE11, Edge, Android Phone, Tablet)
- Use Admin Color
- UI and UX Improvement
- RTL Support
- Use HTML Class for Front End Output + Update Front CSS
= 1.0.0.alpha3 – 29 Sep 2016 =
- Revision: Revert to Revision now also revert to FX Builder data
- Remove disable editor feature. Simpler Settings
- Change settings option name. You need to re-configure settings
- Page is enabled by default
- Introduce Tools: Export / Import FX Builder data
- Auto focus to editor when open editor modal
- Fix Custom CSS textarea line break
- Fix several small-screen accessibility issue in modal box
= 1.0.0.alpha2 – 23 Sep 2016 =
- Add row with thumbnail for each layoout
- Welcome notice with link to admin page
- Improve overall builder design
- Fix overflow in editor modal
- Add post class “fx-builder-entry” when active
- Reset undo in editor modal
- Custom CSS for each posts
- Other small fixes and improvements
= 1.0.0.alpha – 21 Sep 2016 =
- Initial alpha release
KTS Display Widgets
Tim Kaye

Simply show or hide widgets on specified pages. Adds checkboxes to each widget to either show or hide it on specific posts, pages, archives, etc.

Download

More Info
Shorten It
Simone Fioravanti

Create short links, generate corresponding QR code and track hits.

Download

More Info
Plugin for ClassicPress.

Create short link for your posts, your affiliates or your social content.
- Create URL like mysite.com/fb to point to longer internal links or external links like instagram videos, external services or partners.
- Generate QR codes for those links with this plugin (using php-qrcode).
- Keep track of how many times those links are used (without tracking data).
Example

Path: /fbv

Destination: https://www.facebook.com/cris.vardamak/videos/1327994840668572

means that if you connect to https://educatorecinofilo.dog/fbv you will be redirected to https://www.facebook.com/cris.vardamak/videos/1327994840668572.

Conflicts

If redirects are not working properly there may be a conflict with plugins using template_redirect hook.
This hook is used often by SEO plugins to redirect non existing pages.
Take a look at your SEO plugin’s settings.

Screenshots
DebugPress: Debugger in a Popup
Dev4Press

DebugPress is an easy-to-use plugin that implements popups for debugging and profiling website pages with support for intercepting AJAX requests.

Download

More Info
DebugPress is an easy-to-use plugin implementing popup for debugging and profiling currently loaded WordPress powered website page with support for intercepting AJAX requests. The main debugger window is displayed as a popup, activated through the button with the Bug integrated into WordPress Toolbar, or floating on the page.

The plugin currently has a total of 22 tabs in the popup debugger window, showing all kinds of information relevant to the current page, WordPress setup, background AJAX calls, and much more.

The plugin doesn’t modify or replace any WordPress files or functions.

= Home and GitHub =
- Learn more about the plugin: DebugPress Website
- Contribute to plugin development: DebugPress on GitHub
= Quick Overview Video =
https://www.youtube.com/watch?v=-eFnBRLhy-s

= Pretty Print for objects =
To display the content of objects or arrays, plugin has pretty print functionality through use of simpler PrettyPrint library, or more robust third-party library Kint. You can choose one or the other from the plugin Settings, Advanced tab.

= Debugger Panels =
Currently, the plugin has the following panels:
- Basic
- Request (optional)
- Query (for frontend only)
- Content (optional)
- Roles (optional)
- Constants (optional)
- Hooks (optional)
- PHP (optional)
- Server (optional)
- Enqueue (optional)
- SQL Queries (if SQL queries logging is enabled)
- User (optional, if user is logged in only)
- HTTP (optional, if HTTP API calls are captured)
- bbPress (optional, on bbPress forum pages only)
- Plugins (optional, if plugins store data)
- Errors (for all captured PHP errors)
- Doing It Wrong (for captured WordPress Doing It Wrong warnings)
- Deprecated (for captured PHP deprecated warnings)
- AJAX (for captured AJAX calls while page is active)
- Store (for any user stored objects during the page loading)
- Tools (internal and external tools links)
- Debug Log (load content on demand from WordPress ‘debug.log’)
- Layout (control the size, position and activation of the popup)
= SQL Queries =
This panel lists all the queries WordPress has run. It allows you to order the queries by execution order or length of execution, and all queries can be filtered by the query type, database table it targets or the WordPress function that called it. Every query displays the execution time, order, caller functions stack and fully formatted SQL query that is easy to read. For some Dev4Press created plugins (and that list will grow), DebugPress can detect the source of the query and allow you to filter by the plugin calling the query.

= PHP and WordPress Errors =
Plugin has 3 panels dedicated to showing PHP and WordPress errors and warnings. The Plugin captures this information during the page load, and it shows full debug trace as returned by the PHP debug tracing function.

= AJAX =
The plugin tracks every AJAX call coming through WordPress admin-ajax.php handler, and with every response, it returns HTTP headers with AJAX request basic execution information. Right now, plugin is not returning a list of logged errors or SQL queries, because both can produce huge output that goes over the HTTP header limits. Plan is to introduce these in the future plugin versions.

= Info Panels =
In the administration Tools menu, plugin adds DebugPress Info page showing several panels
- PHP Info: full formatted results from phpinfo() function
- OPCache Info: full settings and statistics for the OPCache PHP extension
- MySQL Variables: full MySQL settings retrieved from the database
= Plugin Settings =
The plugin has various options controlling the plugin activation, button integration position, user roles that can see the debugger window, options to attempt overriding WordPress debug flags and options controlling the visibility of optional debugger panels.

= Log into Database =
Debugger popup is visible for the request running in the browser. But there are many requests that are happening in the background (AJAX calls, REST API calls…), and for them, you can’t see errors, call information and other stuff in the debugger. Because of that, DebugPress supports logging of various events into database with the use of ‘coreActivity’ plugin, and it is highly recommended to install and use coreActivity.

Log various debug events into a database with the free plugin: coreActivity Plugin, supporting over 120 events and 10 popular WordPress plugins. DebugPress related events will be logged and available for later analysis, and this includes errors, AJAX calls, and HTTP API calls.

= Documentation and Support =
To get help with the plugin, you can use WordPress.org support forums, or you can use Dev4Press.com support forums.
- Plugin Documentation: DebugPress Website
- Support Forum: Dev4Press Support
Installation

= General Requirements =
- PHP: 7.3 or newer
- Tested with the latest PHP, version 8.3
= WordPress Requirements =
- WordPress: 5.5 or newer
- Tested with the latest WordPress, version 6.5
= Basic Installation =
- Upload folder debugpress to the /wp-content/plugins/ directory
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Plugin settings are available under WordPress ‘Settings’ panel
Frequently Asked Questions

= How I can install this plugin? =
If you are not sure about WordPress plugins installation, here is the quick information: Plugin Installation.

= How can I enable WordPress Debug Mode? =
To enable WordPress debug mode via wp-config.php, check out the article here: WordPress Setup.

= How can I open Debugger popup? =
If you have enabled debugger (for admin side and/or frontend), Debugger is activated via Bug button placed in the WordPress Toolbar or as a float button (depending on the settings). Since version 3.0, you can activate the button via keyboard shortcut, default combination is ctrl+shift+u, but it can be changed in the plugin settings.

= Can I change the size and position of the popup? =
Yes. Once the popup is open, you will find the Layout icon next to the button to close the popup. On the layout panel, you can change the location for the popup, size, modal status and auto activation on page load.

= Where can I configure the plugin? =
Open the WordPress ‘Settings’ menu, there you will find ‘DebugPress’ panel.

Changelog

= 3.9 (2024.05.14) =
- Edit: few more updates and improvements
- Edit: replacement of some native with WordPress functions
- Edit: various small updates and tweaks
- Edit: Kint Pretty Print Library 5.1.1
- Fix: various PHP notices related to PHP 8.1 and newer
= 3.8 (2024.04.24) =
- Edit: few minor tweaks and changes
- Edit: updates to the plugin readme file
- Edit: small changes related to the PHP 8.3 compatibility
- Fix: various PHP notices related to PHP 8.1 and newer
= 3.7 (2024.01.23) =
- Edit: changes related to WordPress and PHP code standards
- Edit: updated Query object for page query conditionals
- Edit: updated Dev4Press Library Query detection versions
- Fix: few compare statements written as assignment
= 3.6 (2023.12.15) =
- Edit: Increase Kint Library depth levels to 12
- Edit: Kint Pretty Print Library 5.1.0
- Fix: Small issue with getting the OPCache version when not allowed by the ser
WP Version Modifier for CP
DigTek

Allows Spoofing the WP Version to Install and Troubleshoot Plugins and Themes in ClassicPress.

Download

More Info
Allows Spoofing the WP Version to Install Plugins and Themes in ClassicPress.

ChangeLog

= 1.0.2 =
6/4/24
- Another Save Error Adjustment…
= 1.0.1 =
6/3/24
- Fix Error when Saving on Some Sites
= 1.0.0 =
5/12/24
- Add Multisite Compatibility
- Change Icon to WP Icon
= 0.9.2 =
4/13/24
- Fix Fatal Error if is_plugin_active() not loaded
= 0.9.1 =
4/9/24
- Code Cleaned
= 0.9.0 =
Initial Release Date – 4/4/24

Installation
1. Upload
2. Activate
Updates will be available in the dashboard like any other plugin
- WP Version has a Dashboard Menu to Access the Settings
ClassicPress Directory Integration
ClassicPress

Install and update plugins from ClassicPress directory and keep ClassicPress themes updated.

Download

More Info
Features
- Plugins and themes from ClassicPress Directory now can update as WP.org plugins.
- Plugins from ClassicPress Directory now can be installed using the “Install CP Plugins” menu under “Plugins” menu.
- Themes from ClassicPress Directory now can be installed using the “Install CP Themes” menu under “Appearance” menu.
WP-CLI commands
- Flush transients: wp cpdi flush
Hooks

apply_filters( "cpdi_images_folder_{$plugin}", string $folder )

Filters the folder where we search for icons and banners.
The filtered path is relative to the plugin’s directory.
Default is /images.

Example:
add_filter( 'cpdi_images_folder_' . basename( __DIR__ ), function ( $source ) { return '/assets/images'; } );
Backdrop Custom Portfolio
luthemes

a very basic portfolio

Download

More Info
Update Manager
Simone Fioravanti

Push updates for your ClassicPress plugins and themes from GitHub or other remote sources.

Download

More Info
Painlessly push updates to your ClassicPress plugin and theme users! Serve updates from GitHub, your own site, or somewhere in the cloud. 100% integrated with the ClassicPress update process; super-slim and performant. Incredibly easy!

With the Update Manager plugin for ClassicPress, developers can push plugin and theme updates out to their end users with ease! This isn’t a fork of a WordPress plugin – this is a brand new plugin built specifically for ClassicPress!

Remote Updates made Easy

No matter where you host your plugin or theme code – GitHub, BitBucket, AWS, or even your own website – the Update Manager plugin makes quick work of pushing updates to your end users. A fantastic tool for plugin and theme developers, agencies, and freelancers!

Simple & Lightweight

The Update Manager only requires that you add a single file to your plugin or theme – and it’s under 30k! There’s no libraries to think about. There’s no huge files to add bloat. There’s no complicated steps to trip you up! And, best of all, your users don’t have to install an extra plugin just to deal with updates.

Complete Integration

The Update Manager plugin is fully integrated with ClassicPress’ core update process. Adding your own icons, banners, and screenshots is as simple as dropping your images into the right directory. When your users click for information about your plugin in their dashboard, the popup windows look fantastic, complete with details, imagery, changelog, reviews…and more! Themes look great, too!

Plugin Integration

To setup a plugin to work with the Update Manager, the following general steps are recommended. This page details each of the steps and describes how to use the plugin going forward.
1. Install and activate the Update Manager plugin on your own site.
2. Add the Update Client file to your own plugin.
3. Create an update endpoint in the Update Manager.
4. Test the endpoint in a browser.
5. Test the update on an actual site.
6. Publish the endpoint.
Install the Update Manager Plugin
1. Install the Update Manager plugin according to the installation instructions.
2. Navigate to Dashboard > Update Manager > Plugins > Add New – this is where you will be managing your plugin updates.
Adding the Update Client file to a Plugin
1. Copy the UpdateClient.class.php file (from the Update Manager plugin) into your plugin’s file structure.
2. Set namespace to a unique value; line 22.
3. Set UPDATE_SERVER to the URL where your Update Manager plugin is installed; line 25.
4. Set USE_DIRECTORY to true to skip loading the class starting from ClassicPress v.2; line 30.
5. Set SECURE_SOURCE to the starting part of the URL of the updated zip file if you want to add an extra layer of security; line 35. See line 236 to understand how check is done.
6. Set UPDATE_TYPE to plugin or theme; line 38.
7. Use require_once('/path/to/UpdateClient.class.php') in your plugin’s primary PHP file to run the update client.
Creating an Update Endpoint for a Plugin
1. Navigate to Dashboard > Update Manager > Plugins > Add New
2. Set the Endpoint Identifier for your plugin; ie, my-plugin-folder/my-plugin-file.php.
3. Add your Plugin Details to the editor; if you have a readme.txt file, you can copy it right in.
4. Optionally, add URLs for any Testing Domains that can receive test updates.
5. Optionally, add contact methods for receiving Notifications of issues.
6. Click Publish to make the update immediately available.
Viewing an Update Endpoint in the Browser

If your update endpoint isn’t working as expected, neither will your update. So, before even testing the update process, it’s a good idea to call up the endpoint in a browser and verify that it looks like valid JSON data. The following steps will allow you to view endpoints in the browser. This is not available for endpoints in Draft status.
1. Navigate to Dashboard > Update Manager > Plugins
2. Hover over any of the listed endpoints and click View Endpoint.
Pushing an Update to all Plugin Users

When you create a new version of your plugin, you’ll need to push it out to your end users. To do this:
1. Navigate to Dashboard > Update Manager > Plugins
2. Click to Edit the particular endpoint.
3. Update the Plugin Details section to reflect the new version’s details.
4. Click to Update the endpoint.
Pushing an Update to Limited Users for Testing Purposes
1. Navigate to Dashboard > Update Manager > Plugins
2. Click to Edit an endpoint.
3. Set the Status to Pending Review.
4. Click to Update the endpoint.
With the plugin in Pending Review status, the update will be made available only to those domains specified in the Testing Domains field. Note that if you are trying to test an update on a plugin that is installed on the same server as the Update Manager plugin, you must still whitelist the domain, otherwise it will not receive the update notification.

Promoting Feedback from your Test Team
1. Navigate to Dashboard > Update Manager > Plugins
2. Click to Edit an endpoint.
3. Add one or more contact methods to the Notifications field.
4. Click to Update the endpoint.
This field accepts multiple email addresses and a single URL, separated by commas. The order is not important. If you supply email addresses, a link will be crafted that prepopulates an email with some basic information. If you supply a URL, it will be used to point the user toward a feedback form, GitHub repo, or wherever. If you supply email(s) and URL, both options will be offered. These links will appear in the test notice that appears in the modal windows.

Pushing Alpha, Beta, and Release Candidate Versions

Semantic versioning is used throughout. You can push updates for alpha, beta, and release candidate versions without any trouble. Let’s say you wanted to run through the basic steps with a version 1.0.0 plugin. You might release a plugin at 1.0.0-alpha. Next, you could bump the version to 1.0.0-beta… and then 1.0.0-rc1, and then 1.0.0-rc2, and then 1.0.0. Each version in that chain succeeds the previous. Here’s the upgrade path, a bit more visually.

1.0.0-alpha < 1.0.0-beta < 1.0.0-rc1 < 1.0.0-rc2 < 1.0.0

Supplemental Note: You can also push sequential updates for a given pre-release (alpha, beta, or RC version). For example, 1.0.0-alpha1 is less than 1.0.0-alpha2 which is less than 1.0.0-alpha3, which is less than…well, you get the idea.

Using Custom Images

You can use your own plugin banner and icon images to improve the end user experience. If you have these images, create an /images/ directory in your plugin and drop them there. They will be automatically discovered and you are free to mix and match any of the following filetypes. If you prefer, you can define your own custom image path; see the filters documentation. If you do not have such images, the default system image will be used for the icon, and your plugin modal windows just won’t have a header graphic. The following are supported:

Normal Images

SVG: icon.svg, banner.svg
PNG: icon-128.png, banner-772x250.png
JPG: icon-128.jpg, banner-772x250.jpg

Retina Images

SVG: icon.svg, banner.svg
PNG: icon-256.png, banner-1544x500.png
JPG: icon-256.jpg, banner-1544x500.jpg

Screenshots

PNG: screenshot-1.png, screenshot-2..png, …
JPG: screenshot-1.jpg, screenshot-2.jpg, …

Note: Screenshots are displayed from lowest to highest, however, they need not be sequentially named. The plugin will find them regardless and will apply the correct caption(s) to the correct image(s).

Theme Integration

To setup a theme to work with the Update Manager, the following general steps are recommended. This page details each of the steps and describes how to use the plugin going forward.
1. Install and activate the Update Manager plugin on your own site.
2. Add the Update Client file to your own theme.
3. Create an update endpoint in the Update Manager.
4. Test the endpoint in a browser.
5. Test the update on an actual site.
6. Publish the endpoint.
Install the Update Manager Plugin
1. Install the Update Manager plugin according to the installation instructions.
2. Navigate to Dashboard > Update Manager > Themes > Add New – this is where you will be managing your theme updates.
Adding the Update Client file to a Theme
1. Copy the UpdateClient.class.php file (from the Update Manager plugin) into your theme’s file structure.
2. Set namespace to a unique value; line 25.
3. Set UPDATE_SERVER to the URL where your Update Manager plugin is installed; line 28.
4. Set UPDATE_TYPE to ‘theme’; line 31.
5. Use require_once('/path/to/UpdateClient.class.php') in your theme’s functions.php file to run the update client.
Creating an Update Endpoint for a Theme
1. Navigate to Dashboard > Update Manager > Themes > Add New
2. Set the Endpoint Identifier for your theme; ie, my-theme-directory-name.
3. Add your Theme Details to the editor; if you have a readme.txt file, you can copy it right in.
4. Optionally, add URLs for any Testing Domains that can receive test updates.
5. Optionally, add contact methods for receiving Notifications of issues.
6. Click Publish to make the update immediately available.
Viewing an Update Endpoint in the Browser

If your update endpoint isn’t working as expected, neither will your update. So, before even testing the update process, it’s a good idea to call up the endpoint in a browser and verify that it looks like valid JSON data. The following steps will allow you to view endpoints in the browser. This is not available for endpoints in Draft status.
1. Navigate to Dashboard > Update Manager > Themes
2. Hover over any of the listed endpoints and click View Endpoint.
Pushing an Update to all Theme Users

When you create a new version of your theme, you’ll need to push it out to your end users. To do this:
1. Navigate to Dashboard > Update Manager > Themes
2. Click to Edit the particular endpoint.
3. Update the Theme Details section to reflect the new version’s details.
4. Click to Update the endpoint.
Pushing an Update to Limited Users for Testing Purposes
1. Navigate to Dashboard > Update Manager > Themes
2. Click to Edit an endpoint.
3. Set the Status to Pending Review.
4. Click to Update the endpoint.
With the theme in Pending Review status, the update will be made available only to those domains specified in the Testing Domains field. Note that if you are trying to test an update on a theme that is installed on the same server as the Update Manager plugin, you must still whitelist the domain, otherwise it will not receive the update notification.

Promoting Feedback from your Test Team
1. Navigate to Dashboard > Update Manager > Themes
2. Click to Edit an endpoint.
3. Add one or more contact methods to the Notifications field.
4. Click to Update the endpoint.
This field accepts multiple email addresses and a single URL, separated by commas. The order is not important. If you supply email addresses, a link will be crafted that prepopulates an email with some basic information. If you supply a URL, it will be used to point the user toward a feedback form, GitHub repo, or wherever. If you supply email(s) and URL, both options will be offered. These links will appear in the test notice that appears in the modal windows.

Pushing Alpha, Beta, and Release Candidate Versions

Semantic versioning is used throughout. You can push updates for alpha, beta, and release candidate versions without any trouble. Let’s say you wanted to run through the basic steps with a version 1.0.0 theme. You might release a theme at 1.0.0-alpha. Next, you could bump the version to 1.0.0-beta… and then 1.0.0-rc1, and then 1.0.0-rc2, and then 1.0.0. Each version in that chain succeeds the previous. Here’s the upgrade path, a bit more visually.

1.0.0-alpha < 1.0.0-beta < 1.0.0-rc1 < 1.0.0-rc2 < 1.0.0

Supplemental Note: You can also push sequential updates for a given pre-release (alpha, beta, or RC version). For example, 1.0.0-alpha1 is less than 1.0.0-alpha2 which is less than 1.0.0-alpha3, which is less than…well, you get the idea.

Transient Inspector

Dashboard > Update Manager > Transients

The Update Manager plugin contains functionality that allows you to view and delete the transients related to plugin and theme updates. This functionality provides a reliable method of forcing an update check, regardless of when the last check took place. Note that this functionality reveals all update data, so, even if a plugin or theme is not integrated with the Update Manager plugin, its update data can be viewed (and deleted) here.

Inspecting Transient Data

Clicking the Plugin Update Data or Theme Update Data tabs will reveal the data stored in your database related to plugin and theme updates. The data is only presented for informational purposes and is not editable on these screens.

Previewing Updates

Clicking the Update Data tab will show plugin and theme update information on the same screen and in a more reader-friendly format.

Delete Plugin Transients

Clicking the text link to delete Plugin transients will delete the data stored in the options table as _site_transient_update_plugins. With this transient data deleted, the system will check for plugin updates on the next page load regardless of when the last update check took place.

Delete Theme Transients

Clicking the text link to delete Theme transients will delete the data stored in the options table as _site_transient_update_themes. With this transient data deleted, the system will check for theme updates on the next page load regardless of when the last update check took place.

Delete Both Transients

Clicking the text link to delete Both transients will delete the data stored in the options table for both _site_transient_update_plugins and _site_transient_update_themes. With this transient data deleted, the system will check for both plugin and theme updates on the next page load regardless of when the last update took place.

Processing Incoming Requests

To work with the data received from incoming requests, the following filter can be added to a utility plugin. This might be used for tracking installations or adding/removing values to/from the request before querying the endpoint for data. This filter accepts 1 argument, $request. Replace {component-type} with either plugin or theme, depending on the type of request you are trying to filter.
```
function some_function_name($request) {

     // Do your processing here.

    // Return the processed request.
    return $request;
}
add_filter('codepotent_update_manager_filter_{component-type}_request', 'some_function_name');
```
Processing Outgoing Responses

When a request is received by the Update Manager plugin, the relevant plugin (or theme) data is assembled and passed back as a response to the calling site. This filter allows final processing of that data before it is returned to the calling site. This filter accepts 2 arguments, data and request and returns the possible-amended data.
```
function some_function_name($data, $request) {

     // Do your processing on $data here.

    // Return the processed data.
    return $data;
}
add_filter('codepotent_update_manager_filter_parsed_component_data', 'some_function_name', 10, 2);
```
Active Installations

The Update Manager plugin does not track or know how many active installations there are of any given plugin. If you are otherwise tracking those numbers, you can filter them into the remote modal windows by adding the following filter to a utility plugin. The filter accepts only uses the first of the two arguments, $number. Replace {identifier} with your plugin identifier, ie, my-plugin-dir/my-plugin-file.php.
```
function some_function_name($number, $identifier) {
    return $number;
}
add_filter('codepotent_update_manager_{identifier}_active_installs', 'some_function_name', 10, 2);
```
Admin Menu

Position To change the admin menu item’s position, this filter can be added to a utility plugin. See also the following table of menu position values.
```
function some_function_name($position) {
    return 22;
}
add_filter('codepotent_update_manager_menu_pos', 'some_function_name');
```
Menu Item Positions 1: Top of menu 2: below Dashboard 5: below Posts 10: below Media 20: below Pages 25: below Comments 60: below first separator 65: below Plugins 70: below Users 75: below Tools 80: below Settings 100: below second separator null: below Comments, in natural order; default

Plugin Images Path & URL

These filters can be used if you already have a particular directory schema under which your plugin’s images are stored. These filters would be used in your own plugin.

Plugin-specific filters

Those new filters prevents plugins from accidentally overwrite other’s path.
```
function new_custom_image_path($path) {
	return plugin_dir_path(__FILE__).'beautifulimages';
}
add_filter('codepotent_update_manager_{plugin-slug}_image_path', 'new_custom_image_path');

function new_custom_image_url($url) {
	return plugin_dir_url(__FILE__).'beautifulimages';
}
add_filter('codepotent_update_manager_{plugin-slug}_image_url', 'new_custom_image_url');
```
Global filters (deprecated since version 2.3.0)

Note that you should always check for the right plugin slug before altering the path, as shown in the examples here. Be sure to replace {plugin-slug} with the slug of your own plugin.
```
function my_custom_image_path($path) {
    if (strpos($path, {plugin-slug}) !== false) {
        $path = '/path/to/your-site/wp-content/plugins/your-plugin-name/assets/images';
    }
    return $path;
}
add_filter('codepotent_update_manager_image_path', 'my_custom_image_path');

function my_custom_image_url($url) {
    if (strpos($path, {plugin-slug}) !== false) {
        $path = 'https://yoursite.com/wp-content/plugins/your-plugin-name/assets/images';
    }
    return $path;
}
add_filter('codepotent_update_manager_image_url', 'my_custom_image_url');
```
Filter Notification

Email Properties If you are using the notification features for endpoints to allow your testers to contact you with feedback, you can filter the default subject and body of the email message with the following filters.
```
function some_function_name($subject) {
    return 'Some custom subject line';
}
add_filter('codepotent_update_manager_notification_email_subject', 'some_function_name');

function some_function_name($body) {
    $body = 'A line followed by two blank lines.'."nn";
    $body .= 'Another line...';
    return $body;
}
add_filter('codepotent_update_manager_notification_email_body', 'some_function_name');
```
Footer Credit

For extension authors, this filter allows for a credit link to be appended to the Code Potent footer text. This filter accepts a single argument, $text, which is an empty string, by default. Note that all HTML is stripped, except for the tag. The URLs can be as long as needed, but, the visible text and links may be truncated at 50 characters. This filter is for adding a credit link, not for marketing text and upsells; misusing this feature will cause it to be removed.
```
function some_function_name($text) {
    return 'Featuring <a href="#">My Extension</a> by <a href="#">Author Name</a>';
}
add_filter('codepotent_update_manager_extension_footer_{your-slug-here}', 'some_function_name');
```
Request body

This filter allows to add fields to the request made by the UpdateClient.class.php. It’s useful for plugin authors that wants to pass data to some Update Manager extension. For example Stats for Update Manager uses it to allow plugin authors to give their users the choice to opt-in or out from their site being counted usage in statistics.
```
function some_function_name($body) {
	if( 'no' === get_option( 'my-slug-usage-statistics' ) ) {
		$body['sfum'] = 'no-log';
	}
	return $body;
}
add_filter('codepotent_update_manager_filter_{your-slug-here}_client_request', 'some_function_name');
```
Manual Installation
- Download the zip file to your local computer
- Login to your ClassicPress website.
- Navigate to Dashboard > Plugins > Add New > Upload Plugin
- Upload the zip file to your site
- Click to Install the plugin
- Click to Activate the plugin
Taxonomy Index
azurecurve

Description Displays index of Categories/Tags or other taxonomy types using taxonomy-index Shortcode. Example use: [taxonomy-index taxonomy='category' ...

Download

More Info
Displays index of Categories/Tags or other taxonomy types using taxonomy-index Shortcode.

Example use: [taxonomy-index taxonomy='category' slug='ice-cream']

Alternative [ti] shortcode can also be used

Taxonomy can be set to category or tag or other taxonomy post type.

This plugin is multisite compatible; each site will need settings to be configured in the admin dashboard.

Installation
- Download the latest release of the plugin from GitHub.
- Upload the entire zip file using the Plugins upload function in your ClassicPress admin panel.
- Activate the plugin.
- Configure relevant settings via the configuration page in the admin control panel (azurecurve menu).
Frequently Asked Questions

Can I translate this plugin?

Yes, the .pot file is in the plugins languages folder; if you do translate this plugin, please sent the .po and .mo files to [email protected] for inclusion in the next version (full credit will be given).

Is this plugin compatible with both WordPress and ClassicPress?

This plugin is developed for ClassicPress, but will likely work on WordPress.

Changelog

Version 1.2.4
- Update readme file for compatibility with ClassicPress Directory.
Version 1.2.3
- Update readme files.
- Update language template.
- Fix bug with azurecurve menu.
Version 1.2.2
- Update azurecurve menu.
- Update readme files.
Version 1.2.1
- Update azurecurve menu and logo.
Version 1.2.0
- Fix plugin action link to use admin_url() function.
- Add plugin icon and banner.
- Update azurecurve plugin menu.
- Amend to only load css when shortcode on page.
Version 1.1.4
- Fix bug with plugin menu.
- Update plugin menu css.
Version 1.1.3
- Upgrade azurecurve plugin to store available plugins in options.
Version 1.1.2
- Update Update Manager class to v2.0.0.
- Update action link.
- Update azurecurve menu icon with compressed image.
Version 1.1.1
- Fix bug with incorrect language load text domain.
Version 1.1.0
- Add integration with Update Manager for automatic updates.
- Fix issue with display of azurecurve menu.
- Change settings page heading.
- Add load_plugin_textdomain to handle translations.
Version 1.0.1
- Update azurecurve menu for easier maintenance.
- Move require of azurecurve menu below security check.
Version 1.0.0
- Initial release for ClassicPress forked from azurecurve Taxonomy Index WordPress Plugin.
Other Notes

azurecurve was one of the first plugin developers to start developing for ClassicPress; all plugins are available from azurecurve Development and are integrated with the Update Manager plugin for fully integrated, no hassle, updates.

The other plugins available from azurecurve are:
- Add Open Graph Tags – details / download
- Add Twitter Cards – details / download
- Avatars – details / download
- BBCode – details / download
- Breadcrumbs – details / download
- Call-out Boxes – details / download
- Check Plugin Status – details / download
- Code – details / download
- Comment Validator – details / download
- Conditional Links – details / download
- Contact Forms – details / download
- Disable FLoC – details / download
- Display After Post Content – details / download
- Estimated Read Time – details / download
- Events – details / download
- Filtered Categories – details / download
- Flags – details / download
- Floating Featured Image – [details](https://developme