woocommerce/includes/class-wc-install.php

1026 lines
33 KiB
PHP
Raw Normal View History

2013-07-25 15:29:25 +00:00
<?php
/**
* Installation related functions and actions.
2013-07-25 15:29:25 +00:00
*
2015-08-10 21:44:32 +00:00
* @author WooThemes
* @category Admin
* @package WooCommerce/Classes
* @version 2.4.1
2013-07-25 15:29:25 +00:00
*/
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
2013-07-25 15:29:25 +00:00
/**
2015-11-03 13:31:20 +00:00
* WC_Install Class.
2013-07-25 15:29:25 +00:00
*/
class WC_Install {
2016-05-11 11:44:23 +00:00
/** @var array DB updates and callbacks that need to be run per version */
2015-04-29 09:47:57 +00:00
private static $db_updates = array(
2016-05-11 11:44:23 +00:00
'2.0.0' => array(
'wc_update_200_file_paths',
'wc_update_200_permalinks',
'wc_update_200_subcat_display',
'wc_update_200_taxrates',
'wc_update_200_line_items',
'wc_update_200_images',
'wc_update_200_db_version',
),
'2.0.9' => array(
'wc_update_209_brazillian_state',
'wc_update_209_db_version',
),
'2.1.0' => array(
'wc_update_210_remove_pages',
'wc_update_210_file_paths',
'wc_update_210_db_version',
),
'2.2.0' => array(
'wc_update_220_shipping',
'wc_update_220_order_status',
'wc_update_220_variations',
'wc_update_220_attributes',
'wc_update_220_db_version',
),
'2.3.0' => array(
'wc_update_230_options',
'wc_update_230_db_version',
),
'2.4.0' => array(
'wc_update_240_options',
'wc_update_240_shipping_methods',
'wc_update_240_api_keys',
'wc_update_240_webhooks',
'wc_update_240_refunds',
'wc_update_240_db_version',
),
'2.4.1' => array(
'wc_update_241_variations',
'wc_update_241_db_version',
),
'2.5.0' => array(
'wc_update_250_currency',
'wc_update_250_db_version',
),
'2.6.0' => array(
'wc_update_260_options',
'wc_update_260_termmeta',
'wc_update_260_zones',
'wc_update_260_zone_methods',
'wc_update_260_refunds',
'wc_update_260_db_version',
),
2015-04-29 09:47:57 +00:00
);
2016-05-11 11:44:23 +00:00
/** @var object Background update class */
private static $background_updater;
2013-07-25 15:29:25 +00:00
/**
* Hook in tabs.
*/
public static function init() {
add_action( 'init', array( __CLASS__, 'check_version' ), 5 );
add_action( 'init', array( __CLASS__, 'init_background_updater' ), 5 );
add_action( 'admin_init', array( __CLASS__, 'install_actions' ) );
add_action( 'in_plugin_update_message-woocommerce/woocommerce.php', array( __CLASS__, 'in_plugin_update_message' ) );
add_filter( 'plugin_action_links_' . WC_PLUGIN_BASENAME, array( __CLASS__, 'plugin_action_links' ) );
add_filter( 'plugin_row_meta', array( __CLASS__, 'plugin_row_meta' ), 10, 2 );
add_filter( 'wpmu_drop_tables', array( __CLASS__, 'wpmu_drop_tables' ) );
add_filter( 'cron_schedules', array( __CLASS__, 'cron_schedules' ) );
2016-04-18 16:05:19 +00:00
add_action( 'woocommerce_plugin_background_installer', array( __CLASS__, 'background_installer' ), 10, 2 );
}
2016-05-11 11:44:23 +00:00
/**
* Init background updates
*/
public static function init_background_updater() {
include_once( dirname( __FILE__ ) . '/class-wc-background-updater.php' );
2016-05-11 11:44:23 +00:00
self::$background_updater = new WC_Background_Updater();
2013-07-25 15:29:25 +00:00
}
/**
* Check WooCommerce version and run the updater is required.
*
* This check is done on all requests and runs if he versions do not match.
2013-07-25 15:29:25 +00:00
*/
public static function check_version() {
if ( ! defined( 'IFRAME_REQUEST' ) && get_option( 'woocommerce_version' ) !== WC()->version ) {
self::install();
do_action( 'woocommerce_updated' );
}
2013-07-25 15:29:25 +00:00
}
/**
* Install actions when a update button is clicked within the admin area.
*
* This function is hooked into admin_init to affect admin only.
2013-07-25 15:29:25 +00:00
*/
public static function install_actions() {
2015-04-29 09:47:57 +00:00
if ( ! empty( $_GET['do_update_woocommerce'] ) ) {
self::update();
WC_Admin_Notices::add_notice( 'update' );
2013-07-25 15:29:25 +00:00
}
if ( ! empty( $_GET['force_update_woocommerce'] ) ) {
do_action( 'wp_wc_updater_cron' );
wp_safe_redirect( admin_url( 'admin.php?page=wc-settings' ) );
}
2013-07-25 15:29:25 +00:00
}
/**
2015-11-03 13:31:20 +00:00
* Install WC.
2013-07-25 15:29:25 +00:00
*/
public static function install() {
global $wpdb;
2015-01-23 13:29:23 +00:00
if ( ! defined( 'WC_INSTALLING' ) ) {
define( 'WC_INSTALLING', true );
}
// Ensure needed classes are loaded
include_once( dirname( __FILE__ ) . '/admin/class-wc-admin-notices.php' );
self::create_options();
self::create_tables();
self::create_roles();
2013-07-25 15:29:25 +00:00
// Register post types
WC_Post_types::register_post_types();
WC_Post_types::register_taxonomies();
2013-07-25 15:29:25 +00:00
// Also register endpoints - this needs to be done prior to rewrite rule flush
WC()->query->init_query_vars();
WC()->query->add_endpoints();
2015-03-20 14:20:12 +00:00
WC_API::add_endpoint();
WC_Auth::add_endpoint();
self::create_terms();
self::create_cron_jobs();
self::create_files();
2013-07-25 15:29:25 +00:00
2015-04-29 09:47:57 +00:00
// Queue upgrades/setup wizard
$current_wc_version = get_option( 'woocommerce_version', null );
$current_db_version = get_option( 'woocommerce_db_version', null );
2013-07-25 15:29:25 +00:00
2015-04-29 09:47:57 +00:00
WC_Admin_Notices::remove_all_notices();
2013-07-25 15:29:25 +00:00
2015-04-29 09:47:57 +00:00
// No versions? This is a new install :)
2015-04-29 09:59:59 +00:00
if ( is_null( $current_wc_version ) && is_null( $current_db_version ) && apply_filters( 'woocommerce_enable_setup_wizard', true ) ) {
2015-04-29 09:47:57 +00:00
WC_Admin_Notices::add_notice( 'install' );
2015-04-29 10:24:29 +00:00
set_transient( '_wc_activation_redirect', 1, 30 );
2013-07-25 15:29:25 +00:00
// No page? Let user run wizard again..
2015-04-30 13:03:31 +00:00
} elseif ( ! get_option( 'woocommerce_cart_page_id' ) ) {
WC_Admin_Notices::add_notice( 'install' );
}
2013-07-25 15:29:25 +00:00
2015-04-29 09:47:57 +00:00
if ( ! is_null( $current_db_version ) && version_compare( $current_db_version, max( array_keys( self::$db_updates ) ), '<' ) ) {
WC_Admin_Notices::add_notice( 'update' );
2013-07-25 15:29:25 +00:00
} else {
2015-04-29 09:47:57 +00:00
self::update_db_version();
2013-07-25 15:29:25 +00:00
}
2015-04-29 09:47:57 +00:00
self::update_wc_version();
2013-07-25 15:29:25 +00:00
// Flush rules after install
2013-07-25 15:29:25 +00:00
flush_rewrite_rules();
2014-12-30 11:11:17 +00:00
delete_transient( 'wc_attribute_taxonomies' );
2013-07-25 15:29:25 +00:00
/*
* Deletes all expired transients. The multi-table delete syntax is used
* to delete the transient record from table a, and the corresponding
* transient_timeout record from table b.
*
* Based on code inside core's upgrade_network() function.
*/
$sql = "DELETE a, b FROM $wpdb->options a, $wpdb->options b
WHERE a.option_name LIKE %s
AND a.option_name NOT LIKE %s
AND b.option_name = CONCAT( '_transient_timeout_', SUBSTRING( a.option_name, 12 ) )
AND b.option_value < %d";
$wpdb->query( $wpdb->prepare( $sql, $wpdb->esc_like( '_transient_' ) . '%', $wpdb->esc_like( '_transient_timeout_' ) . '%', time() ) );
// Trigger action
do_action( 'woocommerce_installed' );
2013-07-25 15:29:25 +00:00
}
2015-04-29 09:47:57 +00:00
/**
2015-11-03 13:31:20 +00:00
* Update WC version to current.
2015-04-29 09:47:57 +00:00
*/
private static function update_wc_version() {
delete_option( 'woocommerce_version' );
add_option( 'woocommerce_version', WC()->version );
}
/**
2016-05-11 11:44:23 +00:00
* Push all needed DB updates to the queue for processing.
2013-07-25 15:29:25 +00:00
*/
private static function update() {
2013-07-25 15:29:25 +00:00
$current_db_version = get_option( 'woocommerce_db_version' );
2016-05-11 13:22:42 +00:00
$logger = new WC_Logger();
$update_queued = false;
2015-04-29 09:47:57 +00:00
2016-05-11 11:44:23 +00:00
foreach ( self::$db_updates as $version => $update_callbacks ) {
if ( version_compare( $current_db_version, $version, '<' ) ) {
2016-05-11 11:44:23 +00:00
foreach ( $update_callbacks as $update_callback ) {
2016-05-11 13:22:42 +00:00
$logger->add( 'wc_db_updates', sprintf( 'Queuing %s - %s', $version, $update_callback ) );
2016-05-11 11:44:23 +00:00
self::$background_updater->push_to_queue( $update_callback );
2016-05-11 13:22:42 +00:00
$update_queued = true;
2016-05-11 11:44:23 +00:00
}
}
2014-05-30 17:27:41 +00:00
}
2016-05-11 13:22:42 +00:00
if ( $update_queued ) {
self::$background_updater->save()->dispatch();
}
2016-05-11 11:44:23 +00:00
}
/**
* Update DB version to current.
* @param string $version
2016-05-11 11:44:23 +00:00
*/
public static function update_db_version( $version = null ) {
delete_option( 'woocommerce_db_version' );
add_option( 'woocommerce_db_version', is_null( $version ) ? WC()->version : $version );
2013-07-25 15:29:25 +00:00
}
/**
2015-11-03 13:31:20 +00:00
* Add more cron schedules.
* @param array $schedules
* @return array
*/
public static function cron_schedules( $schedules ) {
$schedules['monthly'] = array(
'interval' => 2635200,
'display' => __( 'Monthly', 'woocommerce' )
);
return $schedules;
}
2013-07-25 15:29:25 +00:00
/**
2015-11-03 13:31:20 +00:00
* Create cron jobs (clear them first).
2013-07-25 15:29:25 +00:00
*/
private static function create_cron_jobs() {
2013-07-25 15:29:25 +00:00
wp_clear_scheduled_hook( 'woocommerce_scheduled_sales' );
wp_clear_scheduled_hook( 'woocommerce_cancel_unpaid_orders' );
wp_clear_scheduled_hook( 'woocommerce_cleanup_sessions' );
2014-12-23 18:49:43 +00:00
wp_clear_scheduled_hook( 'woocommerce_geoip_updater' );
wp_clear_scheduled_hook( 'woocommerce_tracker_send_event' );
2013-07-25 15:29:25 +00:00
$ve = get_option( 'gmt_offset' ) > 0 ? '+' : '-';
2013-07-25 15:29:25 +00:00
wp_schedule_event( strtotime( '00:00 tomorrow ' . $ve . get_option( 'gmt_offset' ) . ' HOURS' ), 'daily', 'woocommerce_scheduled_sales' );
2013-07-25 15:29:25 +00:00
$held_duration = get_option( 'woocommerce_hold_stock_minutes', '60' );
2013-07-25 15:29:25 +00:00
if ( $held_duration != '' ) {
2013-07-25 15:29:25 +00:00
wp_schedule_single_event( time() + ( absint( $held_duration ) * 60 ), 'woocommerce_cancel_unpaid_orders' );
}
2013-07-25 15:29:25 +00:00
wp_schedule_event( time(), 'twicedaily', 'woocommerce_cleanup_sessions' );
2014-12-23 18:49:43 +00:00
wp_schedule_event( strtotime( 'first tuesday of next month' ), 'monthly', 'woocommerce_geoip_updater' );
wp_schedule_event( time(), apply_filters( 'woocommerce_tracker_event_recurrence', 'daily' ), 'woocommerce_tracker_send_event' );
2013-07-25 15:29:25 +00:00
}
/**
* Create pages that the plugin relies on, storing page id's in variables.
*/
2013-11-18 15:56:04 +00:00
public static function create_pages() {
include_once( dirname( __FILE__ ) . '/admin/wc-admin-functions.php' );
2013-07-25 15:29:25 +00:00
$pages = apply_filters( 'woocommerce_create_pages', array(
'shop' => array(
2014-03-03 14:47:19 +00:00
'name' => _x( 'shop', 'Page slug', 'woocommerce' ),
'title' => _x( 'Shop', 'Page title', 'woocommerce' ),
2013-07-25 15:29:25 +00:00
'content' => ''
),
'cart' => array(
2014-03-03 14:47:19 +00:00
'name' => _x( 'cart', 'Page slug', 'woocommerce' ),
'title' => _x( 'Cart', 'Page title', 'woocommerce' ),
2013-10-23 13:55:18 +00:00
'content' => '[' . apply_filters( 'woocommerce_cart_shortcode_tag', 'woocommerce_cart' ) . ']'
2013-07-25 15:29:25 +00:00
),
'checkout' => array(
'name' => _x( 'checkout', 'Page slug', 'woocommerce' ),
2014-03-03 14:47:19 +00:00
'title' => _x( 'Checkout', 'Page title', 'woocommerce' ),
2013-10-23 13:55:18 +00:00
'content' => '[' . apply_filters( 'woocommerce_checkout_shortcode_tag', 'woocommerce_checkout' ) . ']'
2013-07-25 15:29:25 +00:00
),
'myaccount' => array(
2014-03-03 14:47:19 +00:00
'name' => _x( 'my-account', 'Page slug', 'woocommerce' ),
'title' => _x( 'My Account', 'Page title', 'woocommerce' ),
2013-10-23 13:55:18 +00:00
'content' => '[' . apply_filters( 'woocommerce_my_account_shortcode_tag', 'woocommerce_my_account' ) . ']'
2013-07-25 15:29:25 +00:00
)
) );
foreach ( $pages as $key => $page ) {
wc_create_page( esc_sql( $page['name'] ), 'woocommerce_' . $key . '_page_id', $page['title'], $page['content'], ! empty( $page['parent'] ) ? wc_get_page_id( $page['parent'] ) : '' );
}
delete_transient( 'woocommerce_cache_excluded_uris' );
2013-07-25 15:29:25 +00:00
}
/**
2015-11-03 13:31:20 +00:00
* Default options.
2013-07-25 15:29:25 +00:00
*
2015-11-03 13:31:20 +00:00
* Sets up the default options used on the settings page.
2013-07-25 15:29:25 +00:00
*/
private static function create_options() {
2013-07-25 15:29:25 +00:00
// Include settings so that we can run through defaults
include_once( dirname( __FILE__ ) . '/admin/class-wc-admin-settings.php' );
2013-07-26 14:36:28 +00:00
$settings = WC_Admin_Settings::get_settings_pages();
2013-07-25 15:29:25 +00:00
2013-07-26 14:36:28 +00:00
foreach ( $settings as $section ) {
if ( ! method_exists( $section, 'get_settings' ) ) {
continue;
}
$subsections = array_unique( array_merge( array( '' ), array_keys( $section->get_sections() ) ) );
foreach ( $subsections as $subsection ) {
foreach ( $section->get_settings( $subsection ) as $value ) {
if ( isset( $value['default'] ) && isset( $value['id'] ) ) {
$autoload = isset( $value['autoload'] ) ? (bool) $value['autoload'] : true;
add_option( $value['id'], $value['default'], '', ( $autoload ? 'yes' : 'no' ) );
}
}
}
}
2013-07-25 15:29:25 +00:00
}
/**
* Add the default terms for WC taxonomies - product types and order statuses. Modify this at your own risk.
*/
private static function create_terms() {
$taxonomies = array(
'product_type' => array(
'simple',
'grouped',
'variable',
'external'
)
);
foreach ( $taxonomies as $taxonomy => $terms ) {
foreach ( $terms as $term ) {
if ( ! get_term_by( 'slug', sanitize_title( $term ), $taxonomy ) ) {
wp_insert_term( $term, $taxonomy );
}
}
}
}
2013-07-25 15:29:25 +00:00
/**
* Set up the database tables which the plugin needs to function.
*
* Tables:
* woocommerce_attribute_taxonomies - Table for storing attribute taxonomies - these are user defined
* woocommerce_termmeta - Term meta table - sadly WordPress does not have termmeta so we need our own
* woocommerce_downloadable_product_permissions - Table for storing user and guest download permissions.
* KEY(order_id, product_id, download_id) used for organizing downloads on the My Account page
* woocommerce_order_items - Order line items are stored in a table to make them easily queryable for reports
* woocommerce_order_itemmeta - Order line item meta is stored in a table for storing extra data.
* woocommerce_tax_rates - Tax Rates are stored inside 2 tables making tax queries simple and efficient.
* woocommerce_tax_rate_locations - Each rate can be applied to more than one postcode/city hence the second table.
*/
private static function create_tables() {
global $wpdb;
2013-07-25 15:29:25 +00:00
$wpdb->hide_errors();
require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
2013-07-25 15:29:25 +00:00
/**
* Before updating with DBDELTA, remove any primary keys which could be
* modified due to schema updates.
*/
if ( $wpdb->get_var( "SHOW TABLES LIKE '{$wpdb->prefix}woocommerce_downloadable_product_permissions';" ) ) {
if ( ! $wpdb->get_var( "SHOW COLUMNS FROM `{$wpdb->prefix}woocommerce_downloadable_product_permissions` LIKE 'permission_id';" ) ) {
$wpdb->query( "ALTER TABLE {$wpdb->prefix}woocommerce_downloadable_product_permissions DROP PRIMARY KEY, ADD `permission_id` bigint(20) NOT NULL PRIMARY KEY AUTO_INCREMENT;" );
}
}
dbDelta( self::get_schema() );
}
/**
2015-11-03 13:31:20 +00:00
* Get Table schema.
2016-05-13 16:07:33 +00:00
* https://github.com/woothemes/woocommerce/wiki/Database-Description/
* @return string
*/
private static function get_schema() {
global $wpdb;
$collate = '';
if ( $wpdb->has_cap( 'collation' ) ) {
2016-01-27 10:10:56 +00:00
$collate = $wpdb->get_charset_collate();
}
/*
* Indexes have a maximum size of 767 bytes. Historically, we haven't need to be concerned about that.
* As of WordPress 4.2, however, we moved to utf8mb4, which uses 4 bytes per character. This means that an index which
* used to have room for floor(767/3) = 255 characters, now only has room for floor(767/4) = 191 characters.
*
* This may cause duplicate index notices in logs due to https://core.trac.wordpress.org/ticket/34870 but dropping
* indexes first causes too much load on some servers/larger DB.
*/
$max_index_length = 191;
$tables = "
CREATE TABLE {$wpdb->prefix}woocommerce_sessions (
session_id bigint(20) NOT NULL AUTO_INCREMENT,
session_key char(32) NOT NULL,
session_value longtext NOT NULL,
session_expiry bigint(20) NOT NULL,
Fix duplicate key errors during db upgrade/install Running phpunit tests currently outputs the following errors/warnings: WordPress database error Duplicate key name 'session_id' for query ALTER TABLE wptests_woocommerce_sessions ADD UNIQUE KEY session_id (session_id) made by PHPUnit_TextUI_Command::main, PHPUnit_TextUI_Command->run, PHPUnit_TextUI_Command->handleArguments, PHPUnit_TextUI_Command->handleBootstrap, PHPUnit_Util_Fileloader::checkAndLoad, PHPUnit_Util_Fileloader::load, include_once('/srv/www/woocommerce/htdocs/wp-content/plugins/woocommerce/tests/bootstrap.php'), WC_Unit_Tests_Bootstrap::instance, WC_Unit_Tests_Bootstrap->__construct, require_once('/srv/www/wordpress-develop/tests/phpunit/includes/bootstrap.php'), require_once('wp-settings.php'), do_action('setup_theme'), call_user_func_array, WC_Unit_Tests_Bootstrap->install_wc, WC_Install::install, WC_Install::create_tables, dbDelta WordPress database error Multiple primary key defined for query ALTER TABLE wptests_woocommerce_sessions ADD PRIMARY KEY session_key (session_key) made by PHPUnit_TextUI_Command::main, PHPUnit_TextUI_Command->run, PHPUnit_TextUI_Command->handleArguments, PHPUnit_TextUI_Command->handleBootstrap, PHPUnit_Util_Fileloader::checkAndLoad, PHPUnit_Util_Fileloader::load, include_once('/srv/www/woocommerce/htdocs/wp-content/plugins/woocommerce/tests/bootstrap.php'), WC_Unit_Tests_Bootstrap::instance, WC_Unit_Tests_Bootstrap->__construct, require_once('/srv/www/wordpress-develop/tests/phpunit/includes/bootstrap.php'), require_once('wp-settings.php'), do_action('setup_theme'), call_user_func_array, WC_Unit_Tests_Bootstrap->install_wc, WC_Install::install, WC_Install::create_tables, dbDelta WordPress database error Duplicate key name 'session_id' for query ALTER TABLE wptests_woocommerce_sessions ADD UNIQUE KEY session_id (session_id) made by PHPUnit_TextUI_Command::main, PHPUnit_TextUI_Command->run, PHPUnit_TextUI_TestRunner->doRun, PHPUnit_Framework_TestSuite->run, PHPUnit_Framework_TestSuite->run, PHPUnit_Framework_TestCase->run, PHPUnit_Framework_TestResult->run, PHPUnit_Framework_TestCase->runBare, PHPUnit_Framework_TestCase->runTest, ReflectionMethod->invokeArgs, WooCommerce\Tests\Util\WC_Tests_Install->test_check_version, WC_Install::check_version, WC_Install::install, WC_Install::create_tables, dbDelta WordPress database error Multiple primary key defined for query ALTER TABLE wptests_woocommerce_sessions ADD PRIMARY KEY session_key (session_key) made by PHPUnit_TextUI_Command::main, PHPUnit_TextUI_Command->run, PHPUnit_TextUI_TestRunner->doRun, PHPUnit_Framework_TestSuite->run, PHPUnit_Framework_TestSuite->run, PHPUnit_Framework_TestCase->run, PHPUnit_Framework_TestResult->run, PHPUnit_Framework_TestCase->runBare, PHPUnit_Framework_TestCase->runTest, ReflectionMethod->invokeArgs, WooCommerce\Tests\Util\WC_Tests_Install->test_check_version, WC_Install::check_version, WC_Install::install, WC_Install::create_tables, dbDelta .WordPress database error Duplicate key name 'session_id' for query ALTER TABLE wptests_woocommerce_sessions ADD UNIQUE KEY session_id (session_id) made by PHPUnit_TextUI_Command::main, PHPUnit_TextUI_Command->run, PHPUnit_TextUI_TestRunner->doRun, PHPUnit_Framework_TestSuite->run, PHPUnit_Framework_TestSuite->run, PHPUnit_Framework_TestCase->run, PHPUnit_Framework_TestResult->run, PHPUnit_Framework_TestCase->runBare, PHPUnit_Framework_TestCase->runTest, ReflectionMethod->invokeArgs, WooCommerce\Tests\Util\WC_Tests_Install->test_install, WC_Install::install, WC_Install::create_tables, dbDelta WordPress database error Multiple primary key defined for query ALTER TABLE wptests_woocommerce_sessions ADD PRIMARY KEY session_key (session_key) made by PHPUnit_TextUI_Command::main, PHPUnit_TextUI_Command->run, PHPUnit_TextUI_TestRunner->doRun, PHPUnit_Framework_TestSuite->run, PHPUnit_Framework_TestSuite->run, PHPUnit_Framework_TestCase->run, PHPUnit_Framework_TestResult->run, PHPUnit_Framework_TestCase->runBare, PHPUnit_Framework_TestCase->runTest, ReflectionMethod->invokeArgs, WooCommerce\Tests\Util\WC_Tests_Install->test_install, WC_Install::install, WC_Install::create_tables, dbDelta dbDelta requires very specific syntax (as per http://codex.wordpress.org/Creating_Tables_with_Plugins).
2015-11-05 05:43:56 +00:00
UNIQUE KEY session_id (session_id),
PRIMARY KEY (session_key)
) $collate;
2015-05-15 21:20:49 +00:00
CREATE TABLE {$wpdb->prefix}woocommerce_api_keys (
key_id bigint(20) NOT NULL auto_increment,
user_id bigint(20) NOT NULL,
description longtext NULL,
permissions varchar(10) NOT NULL,
consumer_key char(64) NOT NULL,
consumer_secret char(43) NOT NULL,
nonces longtext NULL,
truncated_key char(7) NOT NULL,
last_access datetime NULL default null,
PRIMARY KEY (key_id),
KEY consumer_key (consumer_key),
KEY consumer_secret (consumer_secret)
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_attribute_taxonomies (
attribute_id bigint(20) NOT NULL auto_increment,
attribute_name varchar(200) NOT NULL,
attribute_label longtext NULL,
attribute_type varchar(200) NOT NULL,
attribute_orderby varchar(200) NOT NULL,
attribute_public int(1) NOT NULL DEFAULT 1,
PRIMARY KEY (attribute_id),
KEY attribute_name (attribute_name($max_index_length))
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_downloadable_product_permissions (
permission_id bigint(20) NOT NULL auto_increment,
download_id varchar(32) NOT NULL,
product_id bigint(20) NOT NULL,
order_id bigint(20) NOT NULL DEFAULT 0,
order_key varchar(200) NOT NULL,
user_email varchar(200) NOT NULL,
user_id bigint(20) NULL,
downloads_remaining varchar(9) NULL,
access_granted datetime NOT NULL default '0000-00-00 00:00:00',
access_expires datetime NULL default null,
download_count bigint(20) NOT NULL DEFAULT 0,
PRIMARY KEY (permission_id),
KEY download_order_key_product (product_id,order_id,order_key($max_index_length),download_id),
KEY download_order_product (download_id,order_id,product_id)
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_order_items (
order_item_id bigint(20) NOT NULL auto_increment,
order_item_name longtext NOT NULL,
order_item_type varchar(200) NOT NULL DEFAULT '',
order_id bigint(20) NOT NULL,
PRIMARY KEY (order_item_id),
KEY order_id (order_id)
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_order_itemmeta (
meta_id bigint(20) NOT NULL auto_increment,
order_item_id bigint(20) NOT NULL,
meta_key varchar(255) default NULL,
meta_value longtext NULL,
PRIMARY KEY (meta_id),
KEY order_item_id (order_item_id),
KEY meta_key (meta_key($max_index_length))
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_tax_rates (
tax_rate_id bigint(20) NOT NULL auto_increment,
tax_rate_country varchar(200) NOT NULL DEFAULT '',
tax_rate_state varchar(200) NOT NULL DEFAULT '',
tax_rate varchar(200) NOT NULL DEFAULT '',
tax_rate_name varchar(200) NOT NULL DEFAULT '',
tax_rate_priority bigint(20) NOT NULL,
tax_rate_compound int(1) NOT NULL DEFAULT 0,
tax_rate_shipping int(1) NOT NULL DEFAULT 1,
tax_rate_order bigint(20) NOT NULL,
tax_rate_class varchar(200) NOT NULL DEFAULT '',
PRIMARY KEY (tax_rate_id),
KEY tax_rate_country (tax_rate_country($max_index_length)),
KEY tax_rate_state (tax_rate_state($max_index_length)),
KEY tax_rate_class (tax_rate_class($max_index_length)),
KEY tax_rate_priority (tax_rate_priority)
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_tax_rate_locations (
location_id bigint(20) NOT NULL auto_increment,
location_code varchar(255) NOT NULL,
tax_rate_id bigint(20) NOT NULL,
location_type varchar(40) NOT NULL,
PRIMARY KEY (location_id),
KEY tax_rate_id (tax_rate_id),
KEY location_type (location_type),
KEY location_type_code (location_type(40),location_code(90))
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_shipping_zones (
zone_id bigint(20) NOT NULL auto_increment,
zone_name varchar(255) NOT NULL,
zone_order bigint(20) NOT NULL,
PRIMARY KEY (zone_id)
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_shipping_zone_locations (
location_id bigint(20) NOT NULL auto_increment,
zone_id bigint(20) NOT NULL,
location_code varchar(255) NOT NULL,
location_type varchar(40) NOT NULL,
2016-01-08 13:17:13 +00:00
PRIMARY KEY (location_id),
KEY location_id (location_id),
KEY location_type (location_type),
2016-01-08 13:56:01 +00:00
KEY location_type_code (location_type(40),location_code(90))
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_shipping_zone_methods (
zone_id bigint(20) NOT NULL,
instance_id bigint(20) NOT NULL auto_increment,
method_id varchar(255) NOT NULL,
method_order bigint(20) NOT NULL,
is_enabled tinyint(1) NOT NULL DEFAULT '1',
2016-01-08 13:17:13 +00:00
PRIMARY KEY (instance_id)
2016-02-02 17:08:32 +00:00
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_payment_tokens (
token_id bigint(20) NOT NULL auto_increment,
gateway_id varchar(255) NOT NULL,
token text NOT NULL,
user_id bigint(20) NOT NULL DEFAULT '0',
type varchar(255) NOT NULL,
is_default tinyint(1) NOT NULL DEFAULT '0',
PRIMARY KEY (token_id),
KEY user_id (user_id)
2016-02-02 17:08:32 +00:00
) $collate;
CREATE TABLE {$wpdb->prefix}woocommerce_payment_tokenmeta (
meta_id bigint(20) NOT NULL auto_increment,
payment_token_id bigint(20) NOT NULL,
meta_key varchar(255) NULL,
meta_value longtext NULL,
PRIMARY KEY (meta_id),
KEY payment_token_id (payment_token_id),
KEY meta_key (meta_key($max_index_length))
) $collate;
";
// Term meta is only needed for old installs.
2016-03-02 18:24:49 +00:00
if ( ! function_exists( 'get_term_meta' ) ) {
$tables .= "
CREATE TABLE {$wpdb->prefix}woocommerce_termmeta (
meta_id bigint(20) NOT NULL auto_increment,
woocommerce_term_id bigint(20) NOT NULL,
meta_key varchar(255) default NULL,
meta_value longtext NULL,
PRIMARY KEY (meta_id),
KEY woocommerce_term_id (woocommerce_term_id),
KEY meta_key (meta_key($max_index_length))
) $collate;
";
}
return $tables;
2013-07-25 15:29:25 +00:00
}
/**
2015-11-03 13:31:20 +00:00
* Create roles and capabilities.
2013-07-25 15:29:25 +00:00
*/
public static function create_roles() {
2013-07-25 15:29:25 +00:00
global $wp_roles;
if ( ! class_exists( 'WP_Roles' ) ) {
return;
}
2013-07-25 15:29:25 +00:00
if ( ! isset( $wp_roles ) ) {
$wp_roles = new WP_Roles();
}
// Customer role
add_role( 'customer', __( 'Customer', 'woocommerce' ), array(
'read' => true
) );
// Shop manager role
add_role( 'shop_manager', __( 'Shop Manager', 'woocommerce' ), array(
'level_9' => true,
'level_8' => true,
'level_7' => true,
'level_6' => true,
'level_5' => true,
'level_4' => true,
'level_3' => true,
'level_2' => true,
'level_1' => true,
'level_0' => true,
'read' => true,
'read_private_pages' => true,
'read_private_posts' => true,
'edit_users' => true,
'edit_posts' => true,
'edit_pages' => true,
'edit_published_posts' => true,
'edit_published_pages' => true,
'edit_private_pages' => true,
'edit_private_posts' => true,
'edit_others_posts' => true,
'edit_others_pages' => true,
'publish_posts' => true,
'publish_pages' => true,
'delete_posts' => true,
'delete_pages' => true,
'delete_private_pages' => true,
'delete_private_posts' => true,
'delete_published_pages' => true,
'delete_published_posts' => true,
'delete_others_posts' => true,
'delete_others_pages' => true,
'manage_categories' => true,
'manage_links' => true,
'moderate_comments' => true,
'unfiltered_html' => true,
'upload_files' => true,
'export' => true,
'import' => true,
'list_users' => true
) );
$capabilities = self::get_core_capabilities();
foreach ( $capabilities as $cap_group ) {
foreach ( $cap_group as $cap ) {
$wp_roles->add_cap( 'shop_manager', $cap );
$wp_roles->add_cap( 'administrator', $cap );
2013-07-25 15:29:25 +00:00
}
}
}
2013-08-09 16:11:15 +00:00
/**
2015-11-03 13:31:20 +00:00
* Get capabilities for WooCommerce - these are assigned to admin/shop manager during installation or reset.
2013-08-09 16:11:15 +00:00
*
* @return array
2013-08-09 16:11:15 +00:00
*/
private static function get_core_capabilities() {
2013-08-09 16:11:15 +00:00
$capabilities = array();
$capabilities['core'] = array(
'manage_woocommerce',
'view_woocommerce_reports'
2013-08-09 16:11:15 +00:00
);
$capability_types = array( 'product', 'shop_order', 'shop_coupon', 'shop_webhook' );
2013-08-09 16:11:15 +00:00
foreach ( $capability_types as $capability_type ) {
2013-08-09 16:11:15 +00:00
$capabilities[ $capability_type ] = array(
// Post type
"edit_{$capability_type}",
"read_{$capability_type}",
"delete_{$capability_type}",
"edit_{$capability_type}s",
"edit_others_{$capability_type}s",
"publish_{$capability_type}s",
"read_private_{$capability_type}s",
"delete_{$capability_type}s",
"delete_private_{$capability_type}s",
"delete_published_{$capability_type}s",
"delete_others_{$capability_type}s",
"edit_private_{$capability_type}s",
"edit_published_{$capability_type}s",
// Terms
"manage_{$capability_type}_terms",
"edit_{$capability_type}_terms",
"delete_{$capability_type}_terms",
"assign_{$capability_type}_terms"
);
}
return $capabilities;
}
/**
* woocommerce_remove_roles function.
*/
public static function remove_roles() {
2013-08-09 16:11:15 +00:00
global $wp_roles;
if ( ! class_exists( 'WP_Roles' ) ) {
return;
}
2013-08-09 16:11:15 +00:00
if ( ! isset( $wp_roles ) ) {
$wp_roles = new WP_Roles();
}
2013-08-09 16:11:15 +00:00
$capabilities = self::get_core_capabilities();
2013-08-09 16:11:15 +00:00
foreach ( $capabilities as $cap_group ) {
foreach ( $cap_group as $cap ) {
$wp_roles->remove_cap( 'shop_manager', $cap );
$wp_roles->remove_cap( 'administrator', $cap );
2013-08-09 16:11:15 +00:00
}
}
remove_role( 'customer' );
remove_role( 'shop_manager' );
2013-08-09 16:11:15 +00:00
}
2013-07-25 15:29:25 +00:00
/**
2015-11-03 13:31:20 +00:00
* Create files/directories.
2013-07-25 15:29:25 +00:00
*/
private static function create_files() {
2013-07-25 15:29:25 +00:00
// Install files and folders for uploading files and prevent hotlinking
$upload_dir = wp_upload_dir();
$download_method = get_option( 'woocommerce_file_download_method', 'force' );
2013-07-25 15:29:25 +00:00
$files = array(
array(
'base' => $upload_dir['basedir'] . '/woocommerce_uploads',
'file' => 'index.html',
'content' => ''
),
array(
'base' => WC_LOG_DIR,
2013-07-25 15:29:25 +00:00
'file' => '.htaccess',
'content' => 'deny from all'
),
array(
'base' => WC_LOG_DIR,
2013-07-25 15:29:25 +00:00
'file' => 'index.html',
'content' => ''
)
);
if ( 'redirect' !== $download_method ) {
$files[] = array(
'base' => $upload_dir['basedir'] . '/woocommerce_uploads',
'file' => '.htaccess',
'content' => 'deny from all'
);
}
2013-07-25 15:29:25 +00:00
foreach ( $files as $file ) {
if ( wp_mkdir_p( $file['base'] ) && ! file_exists( trailingslashit( $file['base'] ) . $file['file'] ) ) {
if ( $file_handle = @fopen( trailingslashit( $file['base'] ) . $file['file'], 'w' ) ) {
fwrite( $file_handle, $file['content'] );
fclose( $file_handle );
}
}
}
}
/**
* Show plugin changes. Code adapted from W3 Total Cache.
*/
public static function in_plugin_update_message( $args ) {
$transient_name = 'wc_upgrade_notice_' . $args['Version'];
if ( false === ( $upgrade_notice = get_transient( $transient_name ) ) ) {
$response = wp_safe_remote_get( 'https://plugins.svn.wordpress.org/woocommerce/trunk/readme.txt' );
if ( ! is_wp_error( $response ) && ! empty( $response['body'] ) ) {
$upgrade_notice = self::parse_update_notice( $response['body'], $args['new_version'] );
set_transient( $transient_name, $upgrade_notice, DAY_IN_SECONDS );
}
}
echo wp_kses_post( $upgrade_notice );
}
/**
2015-11-03 13:31:20 +00:00
* Parse update notice from readme file.
*
* @param string $content
* @param string $new_version
* @return string
*/
private static function parse_update_notice( $content, $new_version ) {
// Output Upgrade Notice.
$matches = null;
$regexp = '~==\s*Upgrade Notice\s*==\s*=\s*(.*)\s*=(.*)(=\s*' . preg_quote( WC_VERSION ) . '\s*=|$)~Uis';
$upgrade_notice = '';
if ( preg_match( $regexp, $content, $matches ) ) {
$version = trim( $matches[1] );
$notices = (array) preg_split('~[\r\n]+~', trim( $matches[2] ) );
// Check the latest stable version and ignore trunk.
if ( $version === $new_version && version_compare( WC_VERSION, $version, '<' ) ) {
$upgrade_notice .= '<div class="wc_plugin_upgrade_notice">';
foreach ( $notices as $index => $line ) {
$upgrade_notice .= wp_kses_post( preg_replace( '~\[([^\]]*)\]\(([^\)]*)\)~', '<a href="${2}">${1}</a>', $line ) );
}
$upgrade_notice .= '</div> ';
}
}
return wp_kses_post( $upgrade_notice );
}
/**
* Show action links on the plugin screen.
*
* @param mixed $links Plugin Action links
* @return array
*/
public static function plugin_action_links( $links ) {
$action_links = array(
'settings' => '<a href="' . admin_url( 'admin.php?page=wc-settings' ) . '" title="' . esc_attr( __( 'View WooCommerce Settings', 'woocommerce' ) ) . '">' . __( 'Settings', 'woocommerce' ) . '</a>',
);
return array_merge( $action_links, $links );
}
/**
* Show row meta on the plugin screen.
*
* @param mixed $links Plugin Row Meta
* @param mixed $file Plugin Base file
* @return array
*/
public static function plugin_row_meta( $links, $file ) {
if ( $file == WC_PLUGIN_BASENAME ) {
$row_meta = array(
2016-07-19 10:30:31 +00:00
'docs' => '<a href="' . esc_url( apply_filters( 'woocommerce_docs_url', 'https://docs.woocommerce.com/documentation/plugins/woocommerce/' ) ) . '" title="' . esc_attr( __( 'View WooCommerce Documentation', 'woocommerce' ) ) . '">' . __( 'Docs', 'woocommerce' ) . '</a>',
'apidocs' => '<a href="' . esc_url( apply_filters( 'woocommerce_apidocs_url', 'https://docs.woocommerce.com/wc-apidocs/' ) ) . '" title="' . esc_attr( __( 'View WooCommerce API Docs', 'woocommerce' ) ) . '">' . __( 'API Docs', 'woocommerce' ) . '</a>',
2016-05-27 01:48:49 +00:00
'support' => '<a href="' . esc_url( apply_filters( 'woocommerce_support_url', 'https://support.woothemes.com/' ) ) . '" title="' . esc_attr( __( 'Visit Premium Customer Support Forum', 'woocommerce' ) ) . '">' . __( 'Premium Support', 'woocommerce' ) . '</a>',
);
return array_merge( $links, $row_meta );
}
return (array) $links;
}
/**
* Uninstall tables when MU blog is deleted.
* @param array $tables
* @return string[]
*/
public static function wpmu_drop_tables( $tables ) {
global $wpdb;
$tables[] = $wpdb->prefix . 'woocommerce_sessions';
$tables[] = $wpdb->prefix . 'woocommerce_api_keys';
$tables[] = $wpdb->prefix . 'woocommerce_attribute_taxonomies';
$tables[] = $wpdb->prefix . 'woocommerce_downloadable_product_permissions';
$tables[] = $wpdb->prefix . 'woocommerce_termmeta';
$tables[] = $wpdb->prefix . 'woocommerce_tax_rates';
$tables[] = $wpdb->prefix . 'woocommerce_tax_rate_locations';
$tables[] = $wpdb->prefix . 'woocommerce_order_items';
$tables[] = $wpdb->prefix . 'woocommerce_order_itemmeta';
return $tables;
}
2016-04-18 16:05:19 +00:00
/**
* Get slug from path
* @param string $key
* @return string
*/
private static function format_plugin_slug( $key ) {
$slug = explode( '/', $key );
$slug = explode( '.', end( $slug ) );
return $slug[0];
}
/**
* Install a plugin from .org in the background via a cron job (used by
* installer - opt in).
* @param string $plugin_to_install_id
* @param array $plugin_to_install
* @since 2.6.0
*/
public static function background_installer( $plugin_to_install_id, $plugin_to_install ) {
if ( ! empty( $plugin_to_install['repo-slug'] ) ) {
require_once( ABSPATH . 'wp-admin/includes/file.php' );
require_once( ABSPATH . 'wp-admin/includes/plugin-install.php' );
require_once( ABSPATH . 'wp-admin/includes/class-wp-upgrader.php' );
require_once( ABSPATH . 'wp-admin/includes/plugin.php' );
WP_Filesystem();
$skin = new Automatic_Upgrader_Skin;
$upgrader = new WP_Upgrader( $skin );
$installed_plugins = array_map( array( __CLASS__, 'format_plugin_slug' ), array_keys( get_plugins() ) );
$plugin_slug = $plugin_to_install['repo-slug'];
$plugin = $plugin_slug . '/' . $plugin_slug . '.php';
$installed = false;
$activate = false;
// See if the plugin is installed already
if ( in_array( $plugin_to_install['repo-slug'], $installed_plugins ) ) {
$installed = true;
$activate = ! is_plugin_active( $plugin );
}
// Install this thing!
if ( ! $installed ) {
// Suppress feedback
ob_start();
try {
$plugin_information = plugins_api( 'plugin_information', array(
'slug' => $plugin_to_install['repo-slug'],
'fields' => array(
'short_description' => false,
'sections' => false,
'requires' => false,
'rating' => false,
'ratings' => false,
'downloaded' => false,
'last_updated' => false,
'added' => false,
'tags' => false,
'homepage' => false,
'donate_link' => false,
'author_profile' => false,
'author' => false,
),
) );
if ( is_wp_error( $plugin_information ) ) {
throw new Exception( $plugin_information->get_error_message() );
}
$package = $plugin_information->download_link;
$download = $upgrader->download_package( $package );
if ( is_wp_error( $download ) ) {
throw new Exception( $download->get_error_message() );
}
$working_dir = $upgrader->unpack_package( $download, true );
if ( is_wp_error( $working_dir ) ) {
throw new Exception( $working_dir->get_error_message() );
}
$result = $upgrader->install_package( array(
'source' => $working_dir,
'destination' => WP_PLUGIN_DIR,
'clear_destination' => false,
'abort_if_destination_exists' => false,
'clear_working' => true,
'hook_extra' => array(
'type' => 'plugin',
'action' => 'install',
),
) );
if ( is_wp_error( $result ) ) {
throw new Exception( $result->get_error_message() );
}
$activate = true;
} catch ( Exception $e ) {
WC_Admin_Notices::add_custom_notice(
$plugin_to_install_id . '_install_error',
sprintf(
__( '%1$s could not be installed (%2$s). %3$sPlease install it manually by clicking here.%4$s', 'woocommerce' ),
2016-04-18 16:05:19 +00:00
$plugin_to_install['name'],
$e->getMessage(),
'<a href="' . esc_url( admin_url( 'index.php?wc-install-plugin-redirect=' . $plugin_to_install['repo-slug'] ) ) . '">',
2016-04-18 16:05:19 +00:00
'</a>'
)
);
}
// Discard feedback
ob_end_clean();
}
wp_clean_plugins_cache();
// Activate this thing
if ( $activate ) {
try {
$result = activate_plugin( $plugin );
if ( is_wp_error( $result ) ) {
throw new Exception( $result->get_error_message() );
}
} catch ( Exception $e ) {
WC_Admin_Notices::add_custom_notice(
$plugin_to_install_id . '_install_error',
sprintf(
__( '%1$s was installed but could not be activated. %2$sPlease activate it manually by clicking here.%3$s', 'woocommerce' ),
2016-04-18 16:05:19 +00:00
$plugin_to_install['name'],
'<a href="' . admin_url( 'plugins.php' ) . '">',
'</a>'
)
);
}
}
}
}
2013-07-25 15:29:25 +00:00
}
WC_Install::init();