File: //proc/self/cwd/wp-content/plugins/code-snippets/php/class-upgrade.php
<?php
/**
* Manages upgrade tasks such as deleting and updating options
*/
class Code_Snippets_Upgrade {
/**
* Instance of database class
* @var Code_Snippets_DB
*/
private $db;
/**
* The current plugin version number
* @var string
*/
private $current_version;
/**
* Class constructor
*
* @param string $version Current plugin version
* @param Code_Snippets_DB $db Instance of database class
*/
public function __construct( $version, Code_Snippets_DB $db ) {
$this->db = $db;
$this->current_version = $version;
}
/**
* Run the upgrade functions
*/
public function run() {
/* Always run multisite upgrades, even if not on the main site, as subsites depend on the network snippet table */
if ( is_multisite() ) {
$this->do_multisite_upgrades();
}
$this->do_site_upgrades();
}
/**
* Perform upgrades for the current site
*/
private function do_site_upgrades() {
$table_name = $this->db->table;
$prev_version = get_option( 'code_snippets_version' );
/* Do nothing if the plugin has not just been updated or installed */
if ( ! version_compare( $prev_version, $this->current_version, '<' ) ) {
return;
}
/* Update the plugin version stored in the database */
$updated = update_option( 'code_snippets_version', $this->current_version );
if ( ! $updated ) {
return; // bail if the data was not successfully saved to prevent this process from repeating
}
$sample_snippets = $this->get_sample_content();
$this->db->create_table( $table_name );
/* Remove outdated user meta */
if ( version_compare( $prev_version, '2.14.1', '<' ) ) {
global $wpdb;
$prefix = $wpdb->get_blog_prefix();
$menu_slug = code_snippets()->get_menu_slug();
$option_name = "{$prefix}managetoplevel_page_{$menu_slug}columnshidden";
// loop through each user ID and remove all matching user meta
foreach ( get_users( array( 'fields' => 'ID' ) ) as $user_id ) {
delete_metadata( 'user', $user_id, $option_name, '', true );
}
}
/* Update the scope column of the database */
if ( version_compare( $prev_version, '2.10.0', '<' ) ) {
$this->migrate_scope_data( $table_name );
}
/* Custom capabilities were removed after version 2.9.5 */
if ( version_compare( $prev_version, '2.9.5', '<=' ) ) {
$role = get_role( apply_filters( 'code_snippets_role', 'administrator' ) );
$role->remove_cap( apply_filters( 'code_snippets_cap', 'manage_snippets' ) );
}
if ( false === $prev_version ) {
if ( apply_filters( 'code_snippets/create_sample_content', true ) ) {
foreach ( $sample_snippets as $sample_snippet ) {
save_snippet( $sample_snippet );
}
}
} elseif ( version_compare( $prev_version, '2.14.0', '<' ) ) {
save_snippet( $sample_snippets['orderby_date'] );
}
}
/**
* Perform multisite-only upgrades
*/
private function do_multisite_upgrades() {
$table_name = $this->db->ms_table;
$prev_version = get_site_option( 'code_snippets_version' );
/* Do nothing if the plugin has not been updated or installed */
if ( ! version_compare( $prev_version, $this->current_version, '<' ) ) {
return;
}
/* Always attempt to create or upgrade the database tables */
$this->db->create_table( $table_name );
/* Update the plugin version stored in the database */
update_site_option( 'code_snippets_version', $this->current_version );
/* Update the scope column of the database */
if ( version_compare( $prev_version, '2.10.0', '<' ) ) {
$this->migrate_scope_data( $table_name );
}
/* Custom capabilities were removed after version 2.9.5 */
if ( version_compare( $prev_version, '2.9.5', '<=' ) ) {
$network_cap = apply_filters( 'code_snippets_network_cap', 'manage_network_snippets' );
foreach ( get_super_admins() as $admin ) {
$user = new WP_User( 0, $admin );
$user->remove_cap( $network_cap );
}
}
}
/**
* Migrate data from the old integer method of storing scopes to the new string method
*
* @param string $table_name
*/
private function migrate_scope_data( $table_name ) {
global $wpdb;
$scopes = array(
0 => 'global',
1 => 'admin',
2 => 'front-end',
);
foreach ( $scopes as $scope_number => $scope_name ) {
$wpdb->query( sprintf(
"UPDATE %s SET scope = '%s' WHERE scope = %d",
$table_name, $scope_name, $scope_number
) );
}
}
/**
* Build a collection of sample snippets for new users to try out.
*
* @return array List of Snippet objects.
*/
private function get_sample_content() {
$tag = "\n\n" . esc_html__( 'You can remove it, or edit it to add your own content.', 'code-snippets' );
$snippets_data = array(
'example_html' => array(
'name' => esc_html__( 'Example HTML shortcode', 'code-snippets' ),
'code' => sprintf(
"\nadd_shortcode( 'shortcode_name', function () {\n\n\t\$out = '<p>%s</p>';\n\n\treturn \$out;\n} );",
wp_strip_all_tags( __( 'write your HTML shortcode content here', 'code-snippets' ) )
),
'desc' => esc_html__( 'This is an example snippet for demonstrating how to add an HTML shortcode.', 'code-snippets' ) . $tag,
'tags' => array( 'shortcode' ),
),
'example_css' => array(
'name' => esc_html__( 'Example CSS snippet', 'code-snippets' ),
'code' => sprintf(
"\nadd_action( 'wp_head', function () { ?>\n<style>\n\n\t/* %s */\n\n</style>\n<?php } );\n",
wp_strip_all_tags( __( 'write your CSS code here', 'code-snippets' ) )
),
'desc' => esc_html__( 'This is an example snippet for demonstrating how to add custom CSS code to your website.', 'code-snippets' ) . $tag,
'tags' => array( 'css' ),
'scope' => 'front-end',
),
'example_js' => array(
'name' => esc_html__( 'Example JavaScript snippet', 'code-snippets' ),
'code' => sprintf(
"\nadd_action( 'wp_head', function () { ?>\n<script>\n\n\t/* %s */\n\n</script>\n<?php } );\n",
wp_strip_all_tags( __( 'write your JavaScript code here', 'code-snippets' ) )
),
'desc' => esc_html__( 'This is an example snippet for demonstrating how to add custom JavaScript code to your website.', 'code-snippets' ) . $tag,
'tags' => array( 'javascript' ),
'scope' => 'front-end',
),
'orderby_name' => array(
'name' => esc_html__( 'Order snippets by name', 'code-snippets' ),
'code' => "\nadd_filter( 'code_snippets/list_table/default_orderby', function () {\n\treturn 'name';\n} );\n",
'desc' => esc_html__( 'Order snippets by name by default in the snippets table.', 'code-snippets' ),
'tags' => array( 'code-snippets-plugin' ),
'scope' => 'admin',
),
'orderby_date' => array(
'name' => esc_html__( 'Order snippets by date', 'code-snippets' ),
'code' => "\nadd_filter( 'code_snippets/list_table/default_orderby', function () {\n\treturn 'modified';\n} );\n" .
"\nadd_filter( 'code_snippets/list_table/default_order', function () {\n\treturn 'desc';\n} );\n",
'desc' => esc_html__( 'Order snippets by last modification date by default in the snippets table.', 'code-snippets' ),
'tags' => array( 'code-snippets-plugin' ),
'scope' => 'admin',
),
);
$snippets = array();
foreach ( $snippets_data as $sample_name => $snippet_data ) {
$snippets[ $sample_name ] = new Code_Snippet( $snippet_data );
}
return $snippets;
}
}