<?php

[0] Fix | Delete

[1] Fix | Delete

namespace Code_Snippets;

[2] Fix | Delete

[3] Fix | Delete

use Code_Snippets\Cloud\Cloud_API;

[4] Fix | Delete

use Code_Snippets\REST_API\Snippets_REST_Controller;

[5] Fix | Delete

use Evaluation\Evaluate_Content;

[6] Fix | Delete

use Evaluation\Evaluate_Functions;

[7] Fix | Delete

[8] Fix | Delete

/**

[9] Fix | Delete

* The main plugin class

[10] Fix | Delete

*

[11] Fix | Delete

* @package Code_Snippets

[12] Fix | Delete

*/

[13] Fix | Delete

class Plugin {

[14] Fix | Delete

[15] Fix | Delete

/**

[16] Fix | Delete

* Current plugin version number

[17] Fix | Delete

*

[18] Fix | Delete

* @var string

[19] Fix | Delete

*/

[20] Fix | Delete

public string $version;

[21] Fix | Delete

[22] Fix | Delete

/**

[23] Fix | Delete

* Filesystem path to the main plugin file

[24] Fix | Delete

*

[25] Fix | Delete

* @var string

[26] Fix | Delete

*/

[27] Fix | Delete

public string $file;

[28] Fix | Delete

[29] Fix | Delete

/**

[30] Fix | Delete

* Database class

[31] Fix | Delete

*

[32] Fix | Delete

* @var DB

[33] Fix | Delete

*/

[34] Fix | Delete

public DB $db;

[35] Fix | Delete

[36] Fix | Delete

/**

[37] Fix | Delete

* Class for evaluating function snippets.

[38] Fix | Delete

*

[39] Fix | Delete

* @var Evaluate_Functions

[40] Fix | Delete

*/

[41] Fix | Delete

public Evaluate_Functions $evaluate_functions;

[42] Fix | Delete

[43] Fix | Delete

/**

[44] Fix | Delete

* Class for evaluating content snippets.

[45] Fix | Delete

*

[46] Fix | Delete

* @var Evaluate_Content

[47] Fix | Delete

*/

[48] Fix | Delete

public Evaluate_Content $evaluate_content;

[49] Fix | Delete

[50] Fix | Delete

/**

[51] Fix | Delete

* Administration area class

[52] Fix | Delete

*

[53] Fix | Delete

* @var Admin

[54] Fix | Delete

*/

[55] Fix | Delete

public Admin $admin;

[56] Fix | Delete

[57] Fix | Delete

/**

[58] Fix | Delete

* Front-end functionality class

[59] Fix | Delete

*

[60] Fix | Delete

* @var Front_End

[61] Fix | Delete

*/

[62] Fix | Delete

public Front_End $front_end;

[63] Fix | Delete

[64] Fix | Delete

/**

[65] Fix | Delete

* Class for managing cloud API actions.

[66] Fix | Delete

*

[67] Fix | Delete

* @var Cloud_API

[68] Fix | Delete

*/

[69] Fix | Delete

public Cloud_API $cloud_api;

[70] Fix | Delete

[71] Fix | Delete

/**

[72] Fix | Delete

* Handles licensing and plugin updates.

[73] Fix | Delete

*

[74] Fix | Delete

* @var Licensing

[75] Fix | Delete

*/

[76] Fix | Delete

public Licensing $licensing;

[77] Fix | Delete

[78] Fix | Delete

/**

[79] Fix | Delete

* Handles snippet handler registration.

[80] Fix | Delete

*

[81] Fix | Delete

* @var Snippet_Handler_Registry

[82] Fix | Delete

*/

[83] Fix | Delete

public Snippet_Handler_Registry $snippet_handler_registry;

[84] Fix | Delete

[85] Fix | Delete

/**

[86] Fix | Delete

* Class constructor

[87] Fix | Delete

*

[88] Fix | Delete

* @param string $version Current plugin version.

[89] Fix | Delete

* @param string $file Path to main plugin file.

[90] Fix | Delete

*/

[91] Fix | Delete

public function __construct( string $version, string $file ) {

[92] Fix | Delete

$this->version = $version;

[93] Fix | Delete

$this->file = $file;

[94] Fix | Delete

[95] Fix | Delete

wp_cache_add_global_groups( CACHE_GROUP );

[96] Fix | Delete

[97] Fix | Delete

add_filter( 'code_snippets/execute_snippets', array( $this, 'disable_snippet_execution' ), 5 );

[98] Fix | Delete

[99] Fix | Delete

if ( isset( $_REQUEST['snippets-safe-mode'] ) ) {

[100] Fix | Delete

add_filter( 'home_url', array( $this, 'add_safe_mode_query_var' ) );

[101] Fix | Delete

add_filter( 'admin_url', array( $this, 'add_safe_mode_query_var' ) );

[102] Fix | Delete

}

[103] Fix | Delete

[104] Fix | Delete

add_action( 'rest_api_init', [ $this, 'init_rest_api' ] );

[105] Fix | Delete

add_action( 'allowed_redirect_hosts', [ $this, 'allow_code_snippets_redirect' ] );

[106] Fix | Delete

}

[107] Fix | Delete

[108] Fix | Delete

/**

[109] Fix | Delete

* Initialise classes and include files

[110] Fix | Delete

*/

[111] Fix | Delete

public function load_plugin() {

[112] Fix | Delete

$includes_path = __DIR__;

[113] Fix | Delete

[114] Fix | Delete

// Database operation functions.

[115] Fix | Delete

$this->db = new DB();

[116] Fix | Delete

[117] Fix | Delete

// Snippet operation functions.

[118] Fix | Delete

require_once $includes_path . '/snippet-ops.php';

[119] Fix | Delete

$this->evaluate_content = new Evaluate_Content( $this->db );

[120] Fix | Delete

$this->evaluate_functions = new Evaluate_Functions( $this->db );

[121] Fix | Delete

[122] Fix | Delete

// CodeMirror editor functions.

[123] Fix | Delete

require_once $includes_path . '/editor.php';

[124] Fix | Delete

[125] Fix | Delete

// General Administration functions.

[126] Fix | Delete

if ( is_admin() ) {

[127] Fix | Delete

$this->admin = new Admin();

[128] Fix | Delete

}

[129] Fix | Delete

[130] Fix | Delete

// Settings component.

[131] Fix | Delete

require_once $includes_path . '/settings/settings-fields.php';

[132] Fix | Delete

require_once $includes_path . '/settings/editor-preview.php';

[133] Fix | Delete

require_once $includes_path . '/settings/class-version-switch.php';

[134] Fix | Delete

require_once $includes_path . '/settings/settings.php';

[135] Fix | Delete

[136] Fix | Delete

// Cloud List Table shared functions.

[137] Fix | Delete

require_once $includes_path . '/cloud/list-table-shared-ops.php';

[138] Fix | Delete

[139] Fix | Delete

// Snippet files.

[140] Fix | Delete

$this->snippet_handler_registry = new Snippet_Handler_Registry( [

[141] Fix | Delete

'php' => new Php_Snippet_Handler(),

[142] Fix | Delete

'html' => new Html_Snippet_Handler(),

[143] Fix | Delete

] );

[144] Fix | Delete

[145] Fix | Delete

$fs = new WordPress_File_System_Adapter();

[146] Fix | Delete

[147] Fix | Delete

$config_repo = new Snippet_Config_Repository( $fs );

[148] Fix | Delete

[149] Fix | Delete

( new Snippet_Files( $this->snippet_handler_registry, $fs, $config_repo ) )->register_hooks();

[150] Fix | Delete

[151] Fix | Delete

$this->front_end = new Front_End();

[152] Fix | Delete

$this->cloud_api = new Cloud_API();

[153] Fix | Delete

[154] Fix | Delete

$upgrade = new Upgrade( $this->version, $this->db );

[155] Fix | Delete

add_action( 'plugins_loaded', array( $upgrade, 'run' ), 0 );

[156] Fix | Delete

$this->licensing = new Licensing();

[157] Fix | Delete

[158] Fix | Delete

// Importers.

[159] Fix | Delete

new Plugins_Import_Manager();

[160] Fix | Delete

new Files_Import_Manager();

[161] Fix | Delete

}

[162] Fix | Delete

[163] Fix | Delete

/**

[164] Fix | Delete

* Register custom REST API controllers.

[165] Fix | Delete

*

[166] Fix | Delete

* @return void

[167] Fix | Delete

*/

[168] Fix | Delete

public function init_rest_api() {

[169] Fix | Delete

$snippets_controller = new Snippets_REST_Controller();

[170] Fix | Delete

$snippets_controller->register_routes();

[171] Fix | Delete

}

[172] Fix | Delete

[173] Fix | Delete

/**

[174] Fix | Delete

* Disable snippet execution if the necessary query var is set.

[175] Fix | Delete

*

[176] Fix | Delete

* @param bool $execute_snippets Current filter value.

[177] Fix | Delete

*

[178] Fix | Delete

* @return bool New filter value.

[179] Fix | Delete

*/

[180] Fix | Delete

public function disable_snippet_execution( bool $execute_snippets ): bool {

[181] Fix | Delete

return ! empty( $_REQUEST['snippets-safe-mode'] ) && $this->current_user_can() ? false : $execute_snippets;

[182] Fix | Delete

}

[183] Fix | Delete

[184] Fix | Delete

/**

[185] Fix | Delete

* Determine whether the menu is full or compact.

[186] Fix | Delete

*

[187] Fix | Delete

* @return bool

[188] Fix | Delete

*/

[189] Fix | Delete

public function is_compact_menu(): bool {

[190] Fix | Delete

return ! is_network_admin() && apply_filters( 'code_snippets_compact_menu', false );

[191] Fix | Delete

}

[192] Fix | Delete

[193] Fix | Delete

/**

[194] Fix | Delete

* Fetch the admin menu slug for a menu.

[195] Fix | Delete

*

[196] Fix | Delete

* @param string $menu Name of menu to retrieve the slug for.

[197] Fix | Delete

*

[198] Fix | Delete

* @return string The menu's slug.

[199] Fix | Delete

*/

[200] Fix | Delete

public function get_menu_slug( string $menu = '' ): string {

[201] Fix | Delete

$add = array( 'single', 'add', 'add-new', 'add-snippet', 'new-snippet', 'add-new-snippet' );

[202] Fix | Delete

$edit = array( 'edit', 'edit-snippet' );

[203] Fix | Delete

$import = array( 'import', 'import-snippets', 'import-code-snippets' );

[204] Fix | Delete

$settings = array( 'settings', 'snippets-settings' );

[205] Fix | Delete

$cloud = array( 'cloud', 'cloud-snippets' );

[206] Fix | Delete

$welcome = array( 'welcome', 'getting-started', 'code-snippets' );

[207] Fix | Delete

[208] Fix | Delete

if ( in_array( $menu, $edit, true ) ) {

[209] Fix | Delete

return 'edit-snippet';

[210] Fix | Delete

} elseif ( in_array( $menu, $add, true ) ) {

[211] Fix | Delete

return 'add-snippet';

[212] Fix | Delete

} elseif ( in_array( $menu, $import, true ) ) {

[213] Fix | Delete

return 'import-code-snippets';

[214] Fix | Delete

} elseif ( in_array( $menu, $settings, true ) ) {

[215] Fix | Delete

return 'snippets-settings';

[216] Fix | Delete

} elseif ( in_array( $menu, $cloud, true ) ) {

[217] Fix | Delete

return 'snippets&type=cloud';

[218] Fix | Delete

} elseif ( in_array( $menu, $welcome, true ) ) {

[219] Fix | Delete

return 'code-snippets-welcome';

[220] Fix | Delete

} else {

[221] Fix | Delete

return 'snippets';

[222] Fix | Delete

}

[223] Fix | Delete

}

[224] Fix | Delete

[225] Fix | Delete

/**

[226] Fix | Delete

* Fetch the URL to a snippets admin menu.

[227] Fix | Delete

*

[228] Fix | Delete

* @param string $menu Name of menu to retrieve the URL to.

[229] Fix | Delete

* @param string $context URL scheme to use.

[230] Fix | Delete

*

[231] Fix | Delete

* @return string The menu's URL.

[232] Fix | Delete

*/

[233] Fix | Delete

public function get_menu_url( string $menu = '', string $context = 'self' ): string {

[234] Fix | Delete

$slug = $this->get_menu_slug( $menu );

[235] Fix | Delete

[236] Fix | Delete

if ( $this->is_compact_menu() && 'network' !== $context ) {

[237] Fix | Delete

$base_slug = $this->get_menu_slug();

[238] Fix | Delete

$url = 'tools.php?page=' . $base_slug;

[239] Fix | Delete

[240] Fix | Delete

if ( $slug !== $base_slug ) {

[241] Fix | Delete

$url .= '&sub=' . $slug;

[242] Fix | Delete

}

[243] Fix | Delete

} else {

[244] Fix | Delete

$url = 'admin.php?page=' . $slug;

[245] Fix | Delete

}

[246] Fix | Delete

[247] Fix | Delete

if ( 'network' === $context ) {

[248] Fix | Delete

return network_admin_url( $url );

[249] Fix | Delete

} elseif ( 'admin' === $context ) {

[250] Fix | Delete

return admin_url( $url );

[251] Fix | Delete

} else {

[252] Fix | Delete

return self_admin_url( $url );

[253] Fix | Delete

}

[254] Fix | Delete

}

[255] Fix | Delete

[256] Fix | Delete

/**

[257] Fix | Delete

* Fetch the admin menu slug for a snippets admin menu.

[258] Fix | Delete

*

[259] Fix | Delete

* @param integer $snippet_id Snippet ID.

[260] Fix | Delete

* @param string $context URL scheme to use.

[261] Fix | Delete

*

[262] Fix | Delete

* @return string The URL to the edit snippet page for that snippet.

[263] Fix | Delete

*/

[264] Fix | Delete

public function get_snippet_edit_url( int $snippet_id, string $context = 'self' ): string {

[265] Fix | Delete

return add_query_arg(

[266] Fix | Delete

'id',

[267] Fix | Delete

absint( $snippet_id ),

[268] Fix | Delete

$this->get_menu_url( 'edit', $context )

[269] Fix | Delete

);

[270] Fix | Delete

}

[271] Fix | Delete

[272] Fix | Delete

/**

[273] Fix | Delete

* Allow redirecting to the Code Snippets site.

[274] Fix | Delete

*

[275] Fix | Delete

* @param array<string> $hosts Allowed hosts.

[276] Fix | Delete

*

[277] Fix | Delete

* @return array Modified allowed hosts.

[278] Fix | Delete

*/

[279] Fix | Delete

public function allow_code_snippets_redirect( array $hosts ): array {

[280] Fix | Delete

$hosts[] = 'codesnippets.pro';

[281] Fix | Delete

$hosts[] = 'snipco.de';

[282] Fix | Delete

return $hosts;

[283] Fix | Delete

}

[284] Fix | Delete

[285] Fix | Delete

/**

[286] Fix | Delete

* Determine whether the current user can perform actions on snippets.

[287] Fix | Delete

*

[288] Fix | Delete

* @return boolean Whether the current user has the required capability.

[289] Fix | Delete

*

[290] Fix | Delete

* @since 2.8.6

[291] Fix | Delete

*/

[292] Fix | Delete

public function current_user_can(): bool {

[293] Fix | Delete

return current_user_can( $this->get_cap() );

[294] Fix | Delete

}

[295] Fix | Delete

[296] Fix | Delete

/**

[297] Fix | Delete

* Retrieve the name of the capability required to manage sub-site snippets.

[298] Fix | Delete

*

[299] Fix | Delete

* @return string

[300] Fix | Delete

*/

[301] Fix | Delete

public function get_cap_name(): string {

[302] Fix | Delete

return apply_filters( 'code_snippets_cap', 'manage_options' );

[303] Fix | Delete

}

[304] Fix | Delete

[305] Fix | Delete

/**

[306] Fix | Delete

* Retrieve the name of the capability required to manage network snippets.

[307] Fix | Delete

*

[308] Fix | Delete

* @return string

[309] Fix | Delete

*/

[310] Fix | Delete

public function get_network_cap_name(): string {

[311] Fix | Delete

return apply_filters( 'code_snippets_network_cap', 'manage_network_options' );

[312] Fix | Delete

}

[313] Fix | Delete

[314] Fix | Delete

/**

[315] Fix | Delete

* Determine if a subsite user menu is enabled via *Network Settings > Enable administration menus*.

[316] Fix | Delete

*

[317] Fix | Delete

* @return bool

[318] Fix | Delete

*/

[319] Fix | Delete

public function is_subsite_menu_enabled(): bool {

[320] Fix | Delete

if ( ! is_multisite() ) {

[321] Fix | Delete

return true;

[322] Fix | Delete

}

[323] Fix | Delete

[324] Fix | Delete

$menu_perms = get_site_option( 'menu_items', array() );

[325] Fix | Delete

return ! empty( $menu_perms['snippets'] );

[326] Fix | Delete

}

[327] Fix | Delete

[328] Fix | Delete

/**

[329] Fix | Delete

* Determine if the current user should have the network snippets capability.

[330] Fix | Delete

*

[331] Fix | Delete

* @return bool

[332] Fix | Delete

*/

[333] Fix | Delete

public function user_can_manage_network_snippets(): bool {

[334] Fix | Delete

return is_super_admin() || current_user_can( $this->get_network_cap_name() );

[335] Fix | Delete

}

[336] Fix | Delete

[337] Fix | Delete

/**

[338] Fix | Delete

* Determine whether the current request originates in the network admin.

[339] Fix | Delete

*

[340] Fix | Delete

* @return bool

[341] Fix | Delete

*/

[342] Fix | Delete

public function is_network_context(): bool {

[343] Fix | Delete

return is_network_admin();

[344] Fix | Delete

}

[345] Fix | Delete

[346] Fix | Delete

/**

[347] Fix | Delete

* Get the required capability to perform a certain action on snippets.

[348] Fix | Delete

* Does not check if the user has this capability or not.

[349] Fix | Delete

*

[350] Fix | Delete

* If multisite, adjusts the capability based on whether the user is viewing

[351] Fix | Delete

* the network dashboard or a subsite and whether the menu is enabled for subsites.

[352] Fix | Delete

*

[353] Fix | Delete

* @return string The capability required to manage snippets.

[354] Fix | Delete

*

[355] Fix | Delete

* @since 2.0

[356] Fix | Delete

*/

[357] Fix | Delete

public function get_cap(): string {

[358] Fix | Delete

if ( is_multisite() && $this->is_network_context() ) {

[359] Fix | Delete

return $this->get_network_cap_name();

[360] Fix | Delete

}

[361] Fix | Delete

[362] Fix | Delete

if ( is_multisite() && ! $this->is_subsite_menu_enabled() ) {

[363] Fix | Delete

return $this->get_network_cap_name();

[364] Fix | Delete

}

[365] Fix | Delete

[366] Fix | Delete

return $this->get_cap_name();

[367] Fix | Delete

}

[368] Fix | Delete

[369] Fix | Delete

/**

[370] Fix | Delete

* Inject the safe mode query var into URLs

[371] Fix | Delete

*

[372] Fix | Delete

* @param string $url Original URL.

[373] Fix | Delete

*

[374] Fix | Delete

* @return string Modified URL.

[375] Fix | Delete

*/

[376] Fix | Delete

public function add_safe_mode_query_var( string $url ): string {

[377] Fix | Delete

return isset( $_REQUEST['snippets-safe-mode'] ) ?

[378] Fix | Delete

add_query_arg( 'snippets-safe-mode', (bool) $_REQUEST['snippets-safe-mode'], $url ) :

[379] Fix | Delete

$url;

[380] Fix | Delete

}

[381] Fix | Delete

[382] Fix | Delete

/**

[383] Fix | Delete

* Retrieve a list of available snippet types and their labels.

[384] Fix | Delete

*

[385] Fix | Delete

* @return array<string, string> Snippet types.

[386] Fix | Delete

*/

[387] Fix | Delete

public static function get_types(): array {

[388] Fix | Delete

return apply_filters(

[389] Fix | Delete

'code_snippets_types',

[390] Fix | Delete

array(

[391] Fix | Delete

'php' => __( 'Functions', 'code-snippets' ),

[392] Fix | Delete

'html' => __( 'Content', 'code-snippets' ),

[393] Fix | Delete

'css' => __( 'Styles', 'code-snippets' ),

[394] Fix | Delete

'js' => __( 'Scripts', 'code-snippets' ),

[395] Fix | Delete

'cloud' => __( 'Codevault', 'code-snippets' ),

[396] Fix | Delete

'cloud_search' => __( 'Cloud Search', 'code-snippets' ),

[397] Fix | Delete

'bundles' => __( 'Bundles', 'code-snippets' ),

[398] Fix | Delete

)

[399] Fix | Delete

);

[400] Fix | Delete

}

[401] Fix | Delete

[402] Fix | Delete

/**

[403] Fix | Delete

* Localise a plugin script to provide the CODE_SNIPPETS object.

[404] Fix | Delete

*

[405] Fix | Delete

* @param string $handle Script handle.

[406] Fix | Delete

*

[407] Fix | Delete

* @return void

[408] Fix | Delete

*/

[409] Fix | Delete

public function localize_script( string $handle ) {

[410] Fix | Delete

wp_localize_script(

[411] Fix | Delete

$handle,

[412] Fix | Delete

'CODE_SNIPPETS',

[413] Fix | Delete

[

[414] Fix | Delete

'isLicensed' => $this->licensing->is_licensed(),

[415] Fix | Delete

'isCloudConnected' => Cloud_API::is_cloud_connection_available(),

[416] Fix | Delete

'restAPI' => [

[417] Fix | Delete

'base' => esc_url_raw( rest_url() ),

[418] Fix | Delete

'snippets' => esc_url_raw( rest_url( Snippets_REST_Controller::get_base_route() ) ),

[419] Fix | Delete

'nonce' => wp_create_nonce( 'wp_rest' ),

[420] Fix | Delete

'localToken' => $this->cloud_api->get_local_token(),

[421] Fix | Delete

],

[422] Fix | Delete

'urls' => [

[423] Fix | Delete

'plugin' => esc_url_raw( plugins_url( '', PLUGIN_FILE ) ),

[424] Fix | Delete

'manage' => esc_url_raw( $this->get_menu_url() ),

[425] Fix | Delete

'edit' => esc_url_raw( $this->get_menu_url( 'edit' ) ),

[426] Fix | Delete

'addNew' => esc_url_raw( $this->get_menu_url( 'add' ) ),

[427] Fix | Delete

],

[428] Fix | Delete

]

[429] Fix | Delete

);

[430] Fix | Delete

}

[431] Fix | Delete

}

[432] Fix | Delete

[433] Fix | Delete