Simone Fioravanti

PHP Error Log Viewer

Simone Fioravanti

The PHP Error Log Viewer plugin for ClassicPress brings your error log straight into your dashboard. Color-coding helps you to quickly scan even the l ...

Download

More Info
The PHP Error Log Viewer plugin for ClassicPress brings your error log straight into your dashboard. Color-coding helps you to quickly scan even the longest of error logs. Or, just filter out the errors you don’t want to see. No more wall-of-text error messages – this plugin turns your PHP error log into an incredibly useful display.

Fast, Lightweight, and User-Friendly

There are lots of debugging plugins out there – debugging suites, really. This plugin isn’t intended to become one of them. The PHP Error Log Viewer plugin handles a very specific task and that is to display the PHP error log in a user-friendly manner than can be easily filtered, styled, sorted, preserved, or purged.

More Debugging, Less Clicking

If you have grown tired of flipping back and forth between screens/browsers/apps/whatever to check and recheck your PHP error log as you’re writing code, this will be incredibly handy for you. There’s a link to the error log within reach at all times and it doesn’t require any special configuration.

Viewing the Error Log

Click the PHP Errors menu item in your admin bar. Hover the menu item momentarily and it will reveal your current PHP version. Alternatively, you can access the error log by navigating to Dashboard > Tools > PHP Error Log.

Filtering the Error Log

The checkboxes across the top of the display allow you to show and hide each of the various types of errors: Deprecated, Notice, Warning, Error, and Other. There are also checkboxes to show and hide the time/date, stack traces, and to sort the error log in reverse. Tick your preferred boxes and click the Apply Filters button to update the display.

Refreshing the Error Log

When viewing the error log, you will find a button to Refresh Error Log at the right side of the page. Clicking this button has the same effect as clicking your browser’s refresh button. The error log will be re-read and displayed fresh.

Purging the Error Log

When viewing the error log, you will find a button to Purge Error Log at the right side of the page. Clicking this button will purge all messages from the error log. A confirmation dialog prevents accidental deletion. If your error log is not writable by the PHP process, you will not see this button.

Purging the Error Log via AJAX

In the admin bar, you will find a link PHP Errors which, when hovered, will expose a link to Purge Error Log. Clicking this button will purge all messages from the error log without redirecting you away from the current page. A confirmation dialog prevents accidental deletion. If your error log is not writable by the PHP process, you will not see this link.

Manually Triggering Errors

As of version 2.2.0, there is a function that allows you to manually trigger user-level notices, warnings, or errors and have them neatly displayed in the error log. Here is an example of creating your own wrapper function for added convenience.
```
/**
     * Creating your own error logging wrapper function
     *
     * This example shows how you might integrate the logging function into your own
     * utility plugin.
     *
     * @param mixed $data   Pass in a string, integer, array, object, etc.
     * @param str $level    Must be notice, warning, or error.
     * @param int $file     Use __FILE__ constant to include filename.
     * @param bool $line    Use __LINE__ constant to include line number.
     */
    function log_data($data, $level='notice', $file=false, $line=false) {

    	// If error log plugin is active and the needed function exists...
    	if (function_exists('codepotent_php_error_log_viewer_log')) {
    		return codepotent_php_error_log_viewer_log($data, $level, $file, $line);
    	}

    	// Or, if error log plugin is inactive, you can include just the needed function...
    	if (file_exists($file = plugin_dir_path(__DIR__).'codepotent-php-error-log-viewer/includes/functions.php')) {
    		require_once($file);
    		return codepotent_php_error_log_viewer_log($data, $level, $file, $line);
    	}

    	// If the error log plugin just doesn't exist, there's a fallback.
    	trigger_error(print_r($data, true), E_USER_WARNING);

    }

    // Elsewhere, send data to the log like this:
    $data = 'whatever type of data';
    log_data($data, 'notice', __FILE__, __LINE__);
```
Display Options

The checkboxes at the top of the error log display allow you to choose which types of error messages you want to see. Check any of the boxes and click the Apply Filter button to update the display.
- Date/Time
  Check this box to show dates, times, and other meta data.
- Notice
  Check this box to show non-critical PHP notices.
- Warning
  Check this box to show non-critical PHP warnings.
- Error
  Check this box to show critical PHP errors.
- Other
  Check this box to show any other errors that didn’t meet the above criteria.
- Show Stack Traces
  Check this box to show stack traces for critical errors. Note that not all critical errors will generate a stack trace.
- Reverse Sort
  Check this box to display the error log with latest errors at the top.
Primary Alert Bubble This filter allows you to hide or redesign the primary (red) alert bubble in the admin bar. This filter accepts a single argument, the markup of the primary alert bubble.
```
function yourprefix_hide_primary_alert($alert) {
    return '';
}
add_filter('codepotent_php_errror_log_viewer_primary_alert', 'yourprefix_hide_primary_alert');
```
Secondary Alert Bubble This filter will allow you to hide or redesign the secondary (gray) alert bubble in the admin bar. This filter accepts a single argument, the markup of the secondary alert bubble.
```
function yourprefix_hide_secondary_alert($alert) {
    return '';
}
add_filter('codepotent_php_errror_log_viewer_primary_alert', 'yourprefix_hide_secondary_alert');
```
Add Content Before Legend

In cases where you need to insert some contextual information, either of the following filters can be used to place the content before or after the legend. These filters receive an empty string as an argument.
```
function yourprefix_before_error_log_legend($markup) {
    $markup = 'This content appears before the legend.';
    return $markup;
}
add_filter('codepotent_php_errror_log_viewer_before_legend', 'yourprefix_before_error_log_legend');
```
Add Content After Legend

Identical to the filter above, except this filter places your contextual content below the legend.
```
function yourprefix_after_error_log_legend($markup) {
    $markup = 'This content appears after the legend.';
    return $markup;
}
add_filter('codepotent_php_errror_log_viewer_after_legend', 'yourprefix_after_error_log_legend');
```
Using Custom Error Colors

To override the color-coding for the error messages and legend, copy the following styles into your theme’s style.css file and make your changes there.
```
/* Deprecated code. */
#codepotent-php-error-log-viewer .php-deprecated, 
.codepotent-php-error-log-viewer-legend-box.item-php-deprecated {
	border-left:10px solid #847545;
	}
/* Notices. */
#codepotent-php-error-log-viewer .php-notice,
.codepotent-php-error-log-viewer-legend-box.item-php-notice {
	border-left:10px solid #ccc;
	}
/* Warnings. */
#codepotent-php-error-log-viewer .php-warning,
.codepotent-php-error-log-viewer-legend-box.item-php-warning {
	border-left:10px solid #ffee58;
	}
/* Errors. */
#codepotent-php-error-log-viewer .php-error,
.codepotent-php-error-log-viewer-legend-box.item-php-error {
	border-left:10px solid #e53935;
	}
/* Stack traces. */
#codepotent-php-error-log-viewer .php-stack-trace-title,
#codepotent-php-error-log-viewer .php-stack-trace-step,
#codepotent-php-error-log-viewer .php-stack-trace-origin,
.codepotent-php-error-log-viewer-legend-box.item-php-stack-trace-title {
	border-left:10px solid #ef9a9a;
	}
/* Any other messages. */
#codepotent-php-error-log-viewer .php-other,
.codepotent-php-error-log-viewer-legend-box.item-php-other {
	border-left:10px solid #00bcd4;
	}
```
Enriched Editor

Simone Fioravanti

Enriched Editor The Enriched Editor plugin adds lots of additional options to the ClassicPress visual editor. This plugin is a fork of TinyMCE Advan ...

Download

More Info
The Enriched Editor plugin adds lots of additional options to the ClassicPress visual editor. This plugin is a fork of TinyMCE Advanced for WordPress and contains no Gutenberg code.

Pre-Installation

If you already have TinyMCE Advanced or WYWIWYG Advanced installed, you will need to deactivate and delete before installing Enriched Editor. If you want to preserve your current editor settings, you can export them to a text file before deleting the current plugin. You can then import those settings back into Enriched Editor after you get it installed.

Editor Options
- Enable Editor for Primary Screens
  Enable the Enriched Editor for primary editing screens, including those for posts, pages, and custom post types.
- Enable Editor for Secondary Areas
  Enable the Enriched Editor for secondary editing areas, including those for text widgets and other textarea inputs.
- Enable Editor for Public Use
  Enable the Enriched Editor for public use, such as in user comments and other textarea inputs.
- Advanced Menu
  Enable the advanced menu (File, Edit, Insert, View, Format, Table, and Tools) for the first row.
- Enhanced Lists
  Enable advanced list options, including upper-case, lower-case, disk, square, circle, etc.
- Right-Click
  Enable link insertion by right-clicking the editor.
- Simplified Links
  Use a simplified dialog for creating links.
- Font Sizing
  Use pixels (instead of points) for font sizes.
- Preserve Paragraphs
  Preserve <p> and <br> tags without replacing them.
- Custom Style Menu
  Pull custom styles from an editor-style.css file and add them to a drop-down menu.
Disable Any Comment

Simone Fioravanti

Disable Any Comment Allows administrators to globally disable comments on their site. Activating this plugin disables every comment. Under the "Tools ...

Download

More Info
Allows administrators to globally disable comments on their site.
- Activating this plugin disables every comment.
- Under the “Tools” menu you can find “Delete Comments” that allows you to bulk delete already made comments.
This plugin is made specifically to use with ClassicPress.

Credits

This plugin is forked from Disable Comments v. 1.9.0 by Samir Shah.

Privacy

To help us know the number of active installations of this plugin, we collect and store anonymized data when the plugin check in for updates. The date and unique plugin identifier are stored as plain text and the requesting URL is stored as a non-reversible hashed value. This data is stored for up to 28 days.
Stats for Update Manager

Simone Fioravanti

Discover how many sites are using your plugins and themes! This is a companion plugin for Update Manager. With Stats for Update Manager you ...

Download

More Info
Discover how many sites are using your plugins and themes!

This is a companion plugin for Update Manager.

With Stats for Update Manager you can count active installations of your plugins and themes that serve updates with Update Manager.

You’ll find a new submenu, Statistics, under the Update Manager menu.

It’s compatible with Update Manager versions 1.x and 2.x.

It supports WP-CLI. See the help typing:
- wp help statistics show
- wp help statistics purge
- wp help statistics delete
When a plugin/theme is in that count

Plugins and themes that queried Update Manager at least once in the last week are considered active. When a plugin/theme have not queried Update Manager in the last 4 week it’s removed from the database table. See filters section to tweak.

It also add the number of active installations in the plugin details. See filters section to tweak.

You can reset the count using the Reset row action.

Disclaimers

This plugin is intended to be used by developers.

Filters

Change/hide the number of active installations in plugin info tab

sfum_active_installations let’s you change/hide the number displayed in the details of your plugins.

Examples:

add_filter('sfum_active_installations', 'example_filter');

Don’t show active installation for my nothing-to-see plugin and raise it to one million for boost!
function example_filter($ar){ unset ($ar['nothing-to-see/nothing-to-see.php']); $ar['boost/boost.php'] = 1000000; return $ar; }
Or simply disable it all
function example_filter($ar){ return []; }
Note: the real number is cached for 6 hours.

Add opt-in or opt-out for your plugin users

Supported by Update Manager Client since 2.3.0. Note: this filter is from Update Manager, not from Stats for Update Manager.
codepotent_update_manager_filter_{$slug}_client_request let’s you inject data in the request made by UpdateClient.class.php.

Example:
add_filter('codepotent_update_manager_filter_my-slug/my-slug.php_client_request', 'example_filter'); function example_filter($body){ if( 'no' === get_option( 'my-slug-usage-statistics' ) ) { $body['sfum'] = 'no-log'; } return $body; }
Recognize your own sites in debug

Note that debug information is displayed only if WP_DEBUG is set to true.

sfum_my_sites let’s you recognize your own sites. They will be marked with an * in the debug informations.
With this filter you can populate an array of sha512-hashed urls.
Example:
add_filter('sfum_my_sites', 'all_my_sites'); function all_my_sites($sha) { $mysites = [ 'https://my-first-site.dog', 'https://www.my-second-site.dog' ]; $myhashes = array_map(function($value){ return hash('sha512', $value); }, $mysites); return $myhashes; }
Configure the timing a plugin/theme is considered active or stale

sfum_inactive_after let’s you configure the number of days before a plugin/theme installation is considered inactive.

sfum_old_after let’s you configure the number of days before a plugin/theme installation is considered stale and will be removed from the database.

Example:
// An entry is old after 2 days and will be removed after 7 add_filter('sfum_inactive_after', 'return_two'); add_filter('sfum_old_after', 'return_seven'); function return_two($days) { return 2; } function return_seven($days) { return 7; }
Note that filtering sfum_old_after to 0 will erase your database when the daily maintenence cronjob is executed.

Prevent specific(s) plugin(s)/theme(s) to be logged

sfum_exclude let’s you configure an array of identifier that are excluded from logging.

Note: this don’t clean your database from already logged ones.

Example:
// Don't log those plugins add_filter('sfum_exclude', 'no_log_please'); function no_log_please($list) { $excluded = [ 'please-dont/log-me.php', 'excluded-plugin/excluded-plugin.php', 'my-theme-slug' ]; return $excluded; }
Shortcodes

[sfum-installs]

The above shortcode returns an integer depicting the total number of all installations (of all plugins and themes) across the web. Developers can use it in a sentence:

Our plugins have [n] active installations!

[sfum-installs id=”my-plugin-folder/my-plugin-file.php”]

Building on the previous example, you can also provide a plugin or theme id. This shortcode returns an integer depicting the total number of installs for the plugin or theme with the given identifier. Developers can use it in a sentence:

My Awesome Plugin has [n] active installations!

My Amazing Theme has [n] active installations!

[sfum-domains]

This shortcode returns an integer depicting the number of unique domains using all of the developer’s plugins. Developers can use it in a sentence:

Code Potent is running on [n] sites!

REST API

To get a list of endpoint identifier and active installations you can access wp-json/stats/v1/stats/.
To enable this, add to wp-config.php this line:
define( 'SFUM_ENABLE_REST', true );
Note that the value of active installation is affected by the filter sfum_active_installations.

GDPR / privacy

This plugin stores data about plugin/theme updates in a table.
You can configure how much time this data is kept using sfum_old_after filter (defaults to 4 weeks).
All the data is removed at plugin uninstall.
- URL of the site asking for updates, sha512 hashed
- plugin/theme checked
- timestamp of the last check
Is up to you to decide if and to inform your plugin/theme users that this data is kept.

To help us know the number of active installations of this (Stats for Update Manager) plugin, we collect and store anonymized data when the plugin check in for updates. The date and unique plugin identifier are stored as plain text and the requesting URL is stored as a non-reversible hashed value. This data is stored for up to 28 days.

To skip Stats for Update Manager from logging, the plugin/theme have to ask for updates defining, in the body of the request done by UpdateClient, $body['sfum']='no-log'.
Since version 2.3.0 of Update Manager client this can be done using a filter.

Screenshot
Vars

Simone Fioravanti

vars With vars you can define name-value associations from the admin. Then, in your content you can insert [vars]name[/vars] and get value display ...

Download

More Info
With vars you can define name-value associations from the admin.

Then, in your content you can insert
[vars]name[/vars]
and get value displayed.

Useful if you have a value (a phone number, number of employees) in several pages that can change, so you can change this once from the admin.

It integrates into TinyMCE by adding a menu (compatible also with TinyMCE v.5).

You can choose which users can manage vars.

Look at the screenshots.

Shortcodes everywhere

There is also an option (that affects every shortcode in your site) to display shortcodes in areas where normally they are not.
- single_post_title
- the_title
- widget_text
- widget_title
- bloginfo
- get_post_metadata
Integration

Security menu

If running ClassicPress 1.1.0 or newer those settings are moved to the Security menu: choose which users can manage vars, what to do with vars when uninstalling and apply shortcodes everywhere

Functions

If you would like to use in your theme/plugin
vars_do('name')
and get value displayed.

Filters

There is a filter called vars_output

An example to capitalize the output.
function vars_output_upper( $string ) { return strtoupper( $string ); } add_filter( 'vars_output', 'vars_output_upper' );
An example to use it to exec PHP code. Dangerous, don’t do it.
You have to open and close php tags in your string.
function vars_output_exec_php( $string ) { ob_start(); eval( "?>" . $string ." " ); $evalContent = ob_get_contents(); ob_end_clean(); return $evalContent; } add_filter( 'vars_output', 'vars_output_exec_php' );
Screenshots

Privacy

To help us know the number of active installations of this plugin, we collect and store anonymized data when the plugin check in for updates. The date and unique plugin identifier are stored as plain text and the requesting URL is stored as a non-reversible hashed value. This data is stored for up to 28 days.
Registration Honeypot

Simone Fioravanti

Registration Honeypot Add a honeypot to your ClassicPress registration form to prevent spambots from creating user accounts. Usage The Registration ...

Download

More Info
Timeless Text

Simone Fioravanti

You've probably seen the phrases. These are common phrases you can find on a great number of websites, often on an "About Us" or bio page. How many of ...

Download

More Info
You’ve probably seen the phrases. These are common phrases you can find on a great number of websites, often on an “About Us” or bio page. How many of those sites will remember to update those numbers each year? With the Timeless Text plugin, those phrases will be automatically updated to ensure they never fall out of sync.

I have 20 years of PHP development experience.

We have 35 years of combined experience!

It all began 2 years ago when…

To Calculate Elapsed Years

To process a single date into the number of elapsed years, use the following format.

Usage
[timeless-text y=2000 m=3 d=15 text=false]

Arguments
- y
  Required The year value of the date to calculate.
- m
  Optional The month value of the date to calculate. Defaults to 1.
- d
  Optional The day value of the date to calculate. Defaults to 1.
- text
  Optional Set to false to suppress the text portion and only return the integer value. Defaults to true.
Examples

I have [timeless-text y=2000 m=1 d=1] of experience with web development.

It all began just [timeless-text y=2000] ago.

So, there we were...that was [timeless-text y=2000 m=11 text=false] long years ago.

To Calculate Combined Years

To process a series of dates into a cumulative number of elapsed years, use the following format.

Usage
[timeless-text combined="2000-03-14, 2010-03-14, 2000-03-14, 2010-03-16" text=false]

Arguments
- combined
  Required The date values to calculate for cumulative years, comma-separated.
- text
  Optional Set to false to suppress the text portion and only return the integer value. Defaults to true.
Examples

Together, we bring [timeless-text combined="2012-03-14, 2010-01-18"] of combined experience to your team.

Note: You must provide 2 or more dates. separated by commas. Each date must include the year, month, and day. You can use hyphens or forward-slashes between those numbers.
Carbon Copy

Simone Fioravanti

Post Duplication In Seconds Copy posts, pages, and custom post types with a single click. The #1 solution for quickly duplicating items, including th ...

Download

More Info
Copy posts, pages, and custom post types with a single click. The #1 solution for quickly duplicating items, including the title, content, and excerpt, as well as taxonomy associations, metadata, custom fields, and comment and trackback settings.

Documentation is in the README.md file that you can also view on GitHub.
You may find helpful user-to-user support at the official ClassicPress support forums.
For issues or feature request GitHub is the right place.

Screenshots
1. Duplication Link Hovering any post, page, or custom post type item exposes a link to Duplicate the item.
2. Duplication Button Duplicating an item from the edit screen is also a one-click operation.
Reviews

“Carbon Copy makes it easy for clients to create posts that perfectly match the look of the rest of the site. This has saved me a lot of calls!”
~ Simone Fioravanti, Plugin Developer
www.gieffeedizioni.it

“This deserves a plugins award – you are a star!”
~ Laurence Bahiirwa, Educator & Developer
Omukiguy on YouTube

“I have Carbon Copy installed on all of my ClassicPress sites.”
~ Wade Striebel, ClassicPress Community Team Lead
wade.striebel.ca

“It is a huge time-saver when you can duplicate posts or pages. I do this with my theme tutorials – huge savings!”
~ André, Theme Developer
www.roughpixels.com/

“Copy and paste is soooo 2000’s – I’m all for tools that quickly take care of tedious tasks such as copying and pasting a bunch of fields.”
~ John Alarcon, Creator
codepotent.com

Frequently Asked Questions

Will the plugin fully copy custom post type items?

Yes. The plugin works with all custom post types and the duplicate record contains the same taxonomy associations and metadata as the original.

Can I duplicate an item’s main fields, without the taxonomy and metadata?

No. A partial copy isn’t a carbon copy, after all.

How do I copy something?

Visit the admin page for the post, page, or custom post type that you want to copy. Hover any row and you will see a link to Duplicate the item. If you are currently editing an item, there’s also a Duplicate button available. In either place, you can use CTRL+click to open the newly created item in a new tab.

Where are the setting located?

There are no settings. The plugin is designed to just work.

What about short URLs – won’t duplication break something?

It would, yes. And that’s why, when you duplicate an item that supports permalinks, the newly created item will have a hyphen and a number appended to it. You can then change the permalink for the new item to whatever you like. And, if you happen to forget to change the permalink on the new item, at least it won’t break anything.

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
Changelog

Version 1.2.3

AUG-29-2022
1. Add headers for the ClassicPress Plugin Directory
Version 1.2.2

JUN-06-2022
1. Fixes for the ClassicPress Plugin Directory
2. Update UpdateClient.class.php
Version 1.2.1

MAY-26-2022
1. Update UpdateClient.class.php
Version 1.2.0

MAY-25-2022
1. I18n
2. Update UpdateClient.class.php
Version 1.1.1

JUL-28-2021
1. Fixed a missing return
2. Remove some unused code
3. Update UpdateClient.class.php
Version 1.1.0

JUN-03-2021
1. Update README.md
2. Update footer credits
3. Update plugin header details
4. Update UpdateClient.class.php file to v 2.1.0
5. Update UPDATE_SERVER url
6. Add constants.php file
7. Add adoption notice
8. Remove public-facing Code Potent links
9. Replace Code Potent graphics with new vendor graphics
Version 1.0.0

MAR-25-2020
1. Official release.
Under Construction

Simone Fioravanti

Redirect not logged in users. Allow testers to see the site sending a magic link.

Download

More Info