Initial commit: WordPress wp-content (themes, plugins, languages)

- Theme: momentry (custom theme with REST API routes) - Plugins: code-snippets (contains all API proxies) - Languages: zh_TW translations - Excludes: cache, backups, uploads, logs
2026-05-29 19:07:56 +08:00
commit 09ef1f000f
6521 changed files with 867163 additions and 0 deletions
--- a/plugins/code-snippets/php/evaluation/class-evaluate-functions.php
+++ b/plugins/code-snippets/php/evaluation/class-evaluate-functions.php
@@ -0,0 +1,193 @@
+<?php
+
+namespace Evaluation;
+
+use Code_Snippets\DB;
+use Code_Snippets\REST_API\Snippets_REST_Controller;
+use Code_Snippets\Settings;
+use Code_Snippets\Snippet_Files;
+use function Code_Snippets\clean_active_snippets_cache;
+use function Code_Snippets\clean_snippets_cache;
+use function Code_Snippets\execute_snippet;
+use function Code_Snippets\code_snippets;
+use function Code_Snippets\execute_snippet_from_flat_file;
+
+/**
+ * Class for evaluating functions snippets.
+ *
+ * @package Code_Snippets
+ */
+class Evaluate_Functions {
+
+	/**
+	 * Database class.
+	 *
+	 * @var DB
+	 */
+	private DB $db;
+
+	/**
+	 * Class constructor.
+	 *
+	 * @param DB $db Database class instance.
+	 */
+	public function __construct( DB $db ) {
+		$this->db = $db;
+		add_action( 'plugins_loaded', [ $this, 'evaluate_early' ], 1 );
+	}
+
+	/**
+	 * Retrieve details about the currently edited snippet, if any.
+	 *
+	 * @return ?array{id: int, table: string}
+	 */
+	private function get_currently_editing_snippet(): ?array {
+		if ( wp_is_json_request() && ! empty( $_SERVER['REQUEST_URI'] ) ) {
+			$url = wp_parse_url( esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) );
+
+			if ( isset( $url['path'] ) && false !== strpos( $url['path'], Snippets_REST_Controller::get_prefixed_base_route() ) ) {
+				$path_parts = explode( '/', $url['path'] );
+				$edit_id = intval( end( $path_parts ) );
+
+				if ( ! empty( $url['query'] ) ) {
+					wp_parse_str( $url['query'], $path_params );
+					$edit_table = isset( $path_params['network'] ) && rest_sanitize_boolean( $path_params['network'] )
+						? $this->db->ms_table
+						: $this->db->table;
+				}
+
+				return [
+					'id'    => $edit_id,
+					'table' => $edit_table ?? $this->db->table,
+				];
+			}
+		}
+
+		return null;
+	}
+
+	/**
+	 * Check if the plugin is running in safe mode.
+	 *
+	 * @return bool
+	 *
+	 * @noinspection PhpUndefinedConstantInspection
+	 */
+	public function is_safe_mode_active(): bool {
+		return ( defined( 'CODE_SNIPPETS_SAFE_MODE' ) && CODE_SNIPPETS_SAFE_MODE ) ||
+		       ! apply_filters( 'code_snippets/execute_snippets', true );
+	}
+
+	/**
+	 * Quickly deactivate a snippet with minimal overhead.
+	 *
+	 * @param int    $snippet_id ID of the snippet to deactivate.
+	 * @param string $table_name Name of the table where the snippet is stored.
+	 *
+	 * @return void
+	 */
+	private function quick_deactivate_snippet( int $snippet_id, string $table_name ) {
+		global $wpdb;
+
+		$active_shared_ids = get_option( 'active_shared_network_snippets', [] );
+		$active_shared_ids = is_array( $active_shared_ids )
+			? array_map( 'intval', $active_shared_ids )
+			: [];
+
+		if ( $table_name === $this->db->ms_table && in_array( $snippet_id, $active_shared_ids, true ) ) {
+			unset( $active_shared_ids[ array_search( $snippet_id, $active_shared_ids, true ) ] );
+			$active_shared_ids = array_values( $active_shared_ids );
+			update_option( 'active_shared_network_snippets', $active_shared_ids );
+			clean_active_snippets_cache( $table_name );
+		} else {
+			$wpdb->update(
+				$table_name,
+				[ 'active' => '0' ],
+				[ 'id' => $snippet_id ],
+				[ '%d' ],
+				[ '%d' ]
+			);
+			clean_snippets_cache( $table_name );
+
+			$network = $table_name === $this->db->ms_table;
+			do_action( 'code_snippets/deactivate_snippet', $snippet_id, $network );
+		}
+	}
+
+	private function evaluate_snippet_flat_file( array $snippet, string $file_path, ?array $edit_snippet = null ) {
+		$snippet_id = $snippet['id'];
+		$code = $snippet['code'];
+		$table_name = $snippet['table'];
+
+		// If the snippet is a single-use snippet, deactivate it before execution to ensure that the process always happens.
+		if ( 'single-use' === $snippet['scope'] ) {
+			$this->quick_deactivate_snippet( $snippet_id, $table_name );
+		}
+
+		if ( ! is_null( $edit_snippet ) && $edit_snippet['id'] === $snippet_id && $edit_snippet['table'] === $table_name ) {
+			return;
+		}
+
+		if ( apply_filters( 'code_snippets/allow_execute_snippet', true, $snippet_id, $table_name ) ) {
+			execute_snippet_from_flat_file( $code, $file_path, $snippet_id );
+		}
+	}
+
+	/**
+	 * Evaluate applicable active snippets as early as possible.
+	 *
+	 * @return bool True if snippets were evaluated, false if safe mode is active.
+	 */
+	public function evaluate_early(): bool {
+		if ( $this->is_safe_mode_active() ) {
+			return false;
+		}
+
+		if ( Snippet_Files::is_active() ) {
+			return $this->evaluate_file_snippets();
+		}
+
+		return $this->evaluate_db_snippets();
+	}
+
+	public function evaluate_db_snippets(): bool {
+		$scopes = [ 'global', 'single-use', is_admin() ? 'admin' : 'front-end' ];
+		$active_snippets = $this->db->fetch_active_snippets( $scopes );
+		$edit_snippet = $this->get_currently_editing_snippet();
+
+		foreach ( $active_snippets as $snippet ) {
+			$snippet_id = $snippet['id'];
+			$code = $snippet['code'];
+			$table_name = $snippet['table'];
+
+			// If the snippet is a single-use snippet, deactivate it before execution to ensure that the process always happens.
+			if ( 'single-use' === $snippet['scope'] ) {
+				$this->quick_deactivate_snippet( $snippet_id, $table_name );
+			}
+
+			if ( apply_filters( 'code_snippets/allow_execute_snippet', true, $snippet_id, $table_name ) &&
+			     ( is_null( $edit_snippet ) || $edit_snippet['id'] !== $snippet_id || $edit_snippet['table'] !== $table_name ) ) {
+				execute_snippet( $code, $snippet_id );
+			}
+		}
+
+		return true;
+	}
+
+	private function evaluate_file_snippets(): bool {
+		$type = 'php';
+		$scopes = [ 'global', 'single-use', is_admin() ? 'admin' : 'front-end' ];
+		$snippets = Snippet_Files::get_active_snippets_from_flat_files( $scopes, $type );
+		$edit_snippet = $this->get_currently_editing_snippet();
+
+		foreach ( $snippets as $snippet ) {
+			$table_name = Snippet_Files::get_hashed_table_name( $snippet['table'] );
+			$base_path = Snippet_Files::get_base_dir( $table_name, $type );
+			$file = $base_path . '/' . $snippet['id'] . '.' . $type;
+
+			$this->evaluate_snippet_flat_file( $snippet, $file, $edit_snippet );
+		}
+
+		return true;
+	}
+}