Hooki un filtri

Visas iepriekšējās lapas izmantoja add_action un add_filter — šī lapa paskaidro, kā tie strādā apakšā, un parāda, kā ap tiem uzbūvēt reālu biznesa loģiku: piekļuves piešķiršanu kursam pēc apmaksas.

1. Darbība (action) vs filtrs (filter)

2. Prioritāte un argumentu skaits

add_action( 'hook_nosaukums', 'funkcija', $prioritate, $argumentu_skaits ) — pēdējie divi parametri ir opcionāli, bet svarīgi:

• Prioritāte (noklusējums 10) — mazāks skaitlis izpildās pirmais. Zemāku prioritāti izmanto, lai kaut ko sagatavotu pirms citiem; augstāku (piem. 999), lai pārliecinātos, ka kas cits (kodols, spraudnis) jau ir paveicis savu darbu — sk. izvēlņu noņemšanas piemēru.
• Argumentu skaits (noklusējums 1) — WordPress pēc noklusējuma padod tikai pirmo hooka argumentu tavai funkcijai. Ja hooks piedāvā vairākus (piem. gettext padod trīs — tulkoto tekstu, oriģinālo tekstu un domēnu), un tavai funkcijai nepieciešami visi, jānorāda skaits:

add_filter('gettext', function($translated, $text, $domain) {
	if ($domain === 'woocommerce' && strpos($text, 'From your account dashboard') !== false) {
		return 'Laipni lūdzam savā kontā!';
	}
	return $translated;
}, 20, 3); // <- "3" nepieciešams, citādi $text un $domain vienmēr būtu null

3. Piemērs: biznesa loģika, kas dzīvo hookā

Kad pasūtījums WooCommerce mainās uz statusu "Pabeigts", tas izsauc hooku woocommerce_order_status_completed ar pasūtījuma ID. Tas ir pareizais vieta, kur piešķirt piekļuvi digitālam produktam — nevis maksājumu procesorā vai kaut kur front-end:

add_action( 'woocommerce_order_status_completed', 'asg_grant_course_access', 10, 1 );

function asg_grant_course_access( $order_id ) {
	$order = wc_get_order( $order_id );
	if ( ! $order ) return;

	$user_id = $order->get_user_id();
	if ( ! $user_id ) return; // Viesu pirkums — izlaižam

	foreach ( $order->get_items() as $item ) {
		$product_id = $item->get_product_id();

		$courses = get_user_meta( $user_id, 'asg_course_access', true );
		if ( ! is_array( $courses ) ) $courses = [];

		$now         = time();
		$four_months = 4 * 30 * DAY_IN_SECONDS;

		// Ja piekļuve jau aktīva — pagarina no beigu datuma, nevis no tagad
		if ( isset( $courses[$product_id] ) && $courses[$product_id]['expires'] > $now ) {
			$courses[$product_id]['expires'] += $four_months;
		} else {
			$courses[$product_id] = [
				'granted' => $now,
				'expires' => $now + $four_months,
				'order_id' => $order_id,
			];
		}

		update_user_meta( $user_id, 'asg_course_access', $courses );
	}
}

// Palīgfunkcija — izmanto to jebkur, kur jāpārbauda piekļuve
function asg_has_course_access( $product_id, $user_id = null ) {
	if ( ! $user_id ) $user_id = get_current_user_id();
	if ( ! $user_id ) return false;

	$courses = get_user_meta( $user_id, 'asg_course_access', true );
	if ( ! is_array( $courses ) || ! isset( $courses[$product_id] ) ) return false;

	return $courses[$product_id]['expires'] > time();
}

Kopsavilkums: kā šīs piecas lapas savienojas

Šis ir viens un tas pats functions.php fails, sadalīts pa tēmām:

• Tēmas uzstādīšana ielādē asgData ar nonce priekšgalam.
• AJAX un nonce izmanto šo asgData nonci, lai droši pievienotu preci grozam.
• Pēc apmaksas šīs lapas hooks woocommerce_order_status_completed piešķir piekļuvi kursam.
• WooCommerce endpointi parāda šo piekļuvi/abonementu lietotāja kontā.
• Lomas un tiesības nosaka, kurš no admin puses drīkst šīs iestatījumus mainīt.