thinkrank / includes / seo / class-author-archives-manager.php

class-author-archives-manager.php in ThinkRank AI SEO – AI SEO Plugin for WordPress: Schema, XML Sitemaps, Meta Tags, Search Console & Local SEO 1.29.0, at includes/seo/class-author-archives-manager.php

207 lines 6.6 KB

Raw Download Zip

1	<?php
2	/**
3	* Author Archives Manager
4	*
5	* Handles author archives functionality including redirects
6	*
7	* @package ThinkRank
8	* @subpackage SEO
9	* @since 1.0.0
10	*/
11
12	declare(strict_types=1);
13
14	namespace ThinkRank\SEO;
15
16	// Prevent direct access.
17	if ( ! defined( 'ABSPATH' ) ) {
18	exit;
19	}
20
21	use ThinkRank\Core\Settings;
22
23	/**
24	* Author Archives Manager Class
25	*
26	* @since 1.0.0
27	*/
28	class Author_Archives_Manager {
29
30	/**
31	* Initialize the manager
32	*
33	* @since 1.0.0
34	* @return void
35	*/
36	public function init(): void {
37	add_action('template_redirect', [$this, 'maybe_redirect_author_archives']);
38	add_filter('thinkrank_robots_meta', [$this, 'filter_robots']);
39	add_filter('pre_get_document_title', [$this, 'modify_document_title'], 15);
40	add_action('wp_head', [$this, 'add_meta_description'], 5);
41	}
42
43	/**
44	* Add meta description for author archives
45	*
46	* @since 1.0.0
47	* @return void
48	*/
49	public function add_meta_description(): void {
50	if (is_author()) {
51	$author_id = get_queried_object_id();
52
53	// A per-author meta description (e.g. imported from another SEO plugin)
54	// overrides the global template.
55	$custom_desc = (string) get_user_meta($author_id, '_thinkrank_meta_description', true);
56	if ($custom_desc !== '') {
57	echo '<meta name="description" content="' . esc_attr($custom_desc) . '" />' . "\n";
58	return;
59	}
60
61	$settings = Settings::instance();
62	// Default value matches what we set in endpoint
63	$template = $settings->get('author_archives_meta_desc', 'Articles written by %author_name% on %site_title%');
64	if (empty($template)) {
65	return;
66	}
67
68	// Get variables
69	$author_name = get_the_author_meta('display_name', $author_id);
70	$site_title = get_bloginfo('name');
71
72	$replacements = [
73	'%author_name%' => $author_name,
74	'%site_title%' => $site_title
75	];
76
77	$meta_desc = str_replace(array_keys($replacements), array_values($replacements), $template);
78	$meta_desc = trim($meta_desc);
79
80	if (!empty($meta_desc)) {
81	echo '<meta name="description" content="' . esc_attr($meta_desc) . '" />' . "\n";
82	}
83	}
84	}
85
86	/**
87	* Modify document title for author archives
88	*
89	* @since 1.0.0
90	* @param string $title Original title
91	* @return string Modified title
92	*/
93	public function modify_document_title(string $title): string {
94	if (is_author()) {
95	$author_id = get_queried_object_id();
96
97	// A per-author SEO title (e.g. imported from another SEO plugin)
98	// overrides the global template entirely.
99	$custom_title = (string) get_user_meta($author_id, '_thinkrank_seo_title', true);
100	if ($custom_title !== '') {
101	return $custom_title;
102	}
103
104	$settings = Settings::instance();
105	$template = $settings->get('author_archives_title', '%author_name% – %site_title% %page%');
106
107	if (empty($template)) {
108	return $title;
109	}
110
111	// Get variables
112	$author_name = get_the_author_meta('display_name', $author_id);
113	$site_title = get_bloginfo('name');
114
115	// Separator
116	$separator = '-';
117	if (class_exists('ThinkRank\SEO\Site_Identity_Manager')) {
118	$separator = \ThinkRank\SEO\Site_Identity_Manager::get_active_separator_symbol();
119	}
120
121	// Page number
122	$page_str = '';
123	$paged = get_query_var('paged') ? (int) get_query_var('paged') : 1;
124	if ($paged > 1) {
125	// translators: %d is the page number for paginated author archives.
126	$page_str = sprintf(__('Page %d', 'thinkrank'), $paged);
127	}
128
129	$replacements = [
130	'%author_name%' => $author_name,
131	'%site_title%' => $site_title,
132	'%separator%' => $separator,
133	'%page%' => $page_str
134	];
135
136	return str_replace(array_keys($replacements), array_values($replacements), $template);
137	}
138	return $title;
139	}
140
141	/**
142	* Filter robots meta tag
143	*
144	* @since 1.0.0
145	* @param array $robots Robots meta array
146	* @return array Filtered robots meta
147	*/
148	public function filter_robots(array $robots): array {
149	if (is_author()) {
150	$settings = Settings::instance();
151	$index = $settings->get('author_archives_index', true);
152
153	if (!$index) {
154	// Remove 'index' if present
155	$index_key = array_search('index', $robots, true);
156	if ($index_key !== false) {
157	unset($robots[$index_key]);
158	}
159	// Add 'noindex' if not present
160	if (!in_array('noindex', $robots, true)) {
161	$robots[] = 'noindex';
162	}
163	} else {
164	// If showing in search results, check if empty archives should be hidden
165	$show_empty = $settings->get('author_archives_show_empty', false);
166	if (!$show_empty) {
167	$author_id = get_queried_object_id();
168	// Check if author has any published posts
169	$post_count = count_user_posts($author_id, 'post', true); // true = only public posts
170	if ((int) $post_count === 0) {
171	// Remove 'index' if present
172	$index_key = array_search('index', $robots, true);
173	if ($index_key !== false) {
174	unset($robots[$index_key]);
175	}
176	// Add 'noindex' if not present
177	if (!in_array('noindex', $robots, true)) {
178	$robots[] = 'noindex';
179	}
180	}
181	}
182	}
183	}
184
185	return array_values($robots);
186	}
187
188	/**
189	* Redirect author archives to homepage if disabled
190	*
191	* @since 1.0.0
192	* @return void
193	*/
194	public function maybe_redirect_author_archives(): void {
195	if (is_author()) {
196	$settings = Settings::instance();
197	// Default to true (enabled)
198	$enabled = $settings->get('author_archives_enabled', true);
199
200	if (!$enabled) {
201	wp_safe_redirect(home_url(), 301);
202	exit;
203	}
204	}
205	}
206	}
207