v0.1.0

includes/class-robotstxt-manager-loader.php

@@ -0,0 +1,108 @@
+<?php
+/**
+ * Registers all WordPress hooks for the plugin.
+ *
+ * @package Robotstxt_Manager
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Class Robotstxt_Manager_Loader
+ *
+ * Collects all actions and filters to be registered with WordPress and
+ * registers them in bulk when run() is called.
+ */
+class Robotstxt_Manager_Loader {
+
+	/**
+	 * Registered action hooks.
+	 *
+	 * @var array<int, array{hook: string, component: object, callback: string, priority: int, accepted_args: int}>
+	 */
+	private array $actions = array();
+
+	/**
+	 * Registered filter hooks.
+	 *
+	 * @var array<int, array{hook: string, component: object, callback: string, priority: int, accepted_args: int}>
+	 */
+	private array $filters = array();
+
+	/**
+	 * Queues an action hook for registration.
+	 *
+	 * @param string $hook          The name of the WordPress action.
+	 * @param object $component     The object instance containing the callback.
+	 * @param string $callback      The method name to call on $component.
+	 * @param int    $priority      Hook priority. Default 10.
+	 * @param int    $accepted_args Number of arguments the callback accepts. Default 1.
+	 *
+	 * @return void
+	 */
+	public function add_action(
+		string $hook,
+		object $component,
+		string $callback,
+		int $priority = 10,
+		int $accepted_args = 1
+	): void {
+		$this->actions[] = array(
+			'hook'          => $hook,
+			'component'     => $component,
+			'callback'      => $callback,
+			'priority'      => $priority,
+			'accepted_args' => $accepted_args,
+		);
+	}
+
+	/**
+	 * Queues a filter hook for registration.
+	 *
+	 * @param string $hook          The name of the WordPress filter.
+	 * @param object $component     The object instance containing the callback.
+	 * @param string $callback      The method name to call on $component.
+	 * @param int    $priority      Hook priority. Default 10.
+	 * @param int    $accepted_args Number of arguments the callback accepts. Default 1.
+	 *
+	 * @return void
+	 */
+	public function add_filter(
+		string $hook,
+		object $component,
+		string $callback,
+		int $priority = 10,
+		int $accepted_args = 1
+	): void {
+		$this->filters[] = array(
+			'hook'          => $hook,
+			'component'     => $component,
+			'callback'      => $callback,
+			'priority'      => $priority,
+			'accepted_args' => $accepted_args,
+		);
+	}
+
+	/**
+	 * Registers all queued actions and filters with WordPress.
+	 *
+	 * @return void
+	 */
+	public function run(): void {
+		foreach ( $this->actions as $hook ) {
+			$cb = array( $hook['component'], $hook['callback'] );
+			if ( is_callable( $cb ) ) {
+				add_action( $hook['hook'], $cb, $hook['priority'], $hook['accepted_args'] );
+			}
+		}
+
+		foreach ( $this->filters as $hook ) {
+			$cb = array( $hook['component'], $hook['callback'] );
+			if ( is_callable( $cb ) ) {
+				add_filter( $hook['hook'], $cb, $hook['priority'], $hook['accepted_args'] );
+			}
+		}
+	}
+}