← All changes | includes/core/class-plan-config.php +89 -126 1.27.0 → 2.7.0 View file →

		@@ -8,11 +8,10 @@
8	8	* reads from here. No feature code should check `defined('THINKRANK_PRO_VERSION')`
9	9	* or `apply_filters('thinkrank_is_pro_active', ...)` directly — call these methods
10	10	* instead so a single override flips behavior everywhere.
11	11	*
12		- * The Pro plugin attaches by filtering `thinkrank_email_report_capabilities`
13		- * (or the analogous filter for other features). It never needs to fork or
14		- * monkey-patch this file.
	12	+ * The Pro plugin attaches by filtering each feature's capability map. It never
	13	+ * needs to fork or monkey-patch this file.
15	14	*
16	15	* @package ThinkRank\Core
17	16	* @since 1.9.0
18	17	*/
		@@ -28,10 +27,10 @@
28	27	/**
29	28	* Plan_Config — capability registry for free/pro feature gating.
30	29	*
31	30	* Usage:
32		- * if (Plan_Config::can('custom_subject', 'email_report')) { ... }
33		- * $caps = Plan_Config::email_report();
	31	+ * if (Plan_Config::can('usage_policy', 'llms_txt')) { ... }
	32	+ * $caps = Plan_Config::llms_txt();
34	33	*
35	34	* @since 1.9.0
36	35	*/
37	36	final class Plan_Config {
		@@ -50,115 +49,116 @@
50	49	);
51	50	}
52	51
53	52	/**
54		- * Capability map for the Email Reporting feature.
	53	+ * Capability map for the llms.txt feature.
55	54	*
56		- * Returns a flat array of capability_key => bool|int|array describing
57		- * what the current plan can do. The Pro plugin filters this to enable
58		- * its capabilities.
	55	+ * Generating and editing llms.txt is FREE and stays free. What Pro adds is
	56	+ * the usage policy: the `Training:` / `Summarization:` / `Embedding:` /
	57	+ * `Require-Attribution:` directives that state what agents may do with the
	58	+ * content, rather than describing the content itself (#160 in Pro).
59	59	*
60		- * Schema (keep in sync with src/admin/config/email-report-plan.js):
61		- * - allowed_frequencies int[] Days between sends user may pick.
62		- * - max_recipients int Max addresses on the recipients field.
63		- * - recipients_locked_to string|null 'admin_email' = pre-filled & read-only.
64		- * - custom_subject bool May edit subject template.
65		- * - custom_logo bool May upload a header logo.
66		- * - logo_link bool May set a click-through URL on the logo.
67		- * - header_background bool May set a custom header background CSS.
68		- * - link_to_full_report bool May toggle the dashboard CTA at the foot.
69		- * - intro_text bool May set a custom intro paragraph.
70		- * - sections_configurable bool May enable/disable individual sections.
71		- * - footer_text bool May set a custom footer paragraph.
72		- * - additional_css bool May inject additional CSS into the email.
73		- * - ai_highlights bool May render the AI Highlights section.
	60	+ * Schema:
	61	+ * usage_policy bool May publish usage-policy directives in llms.txt.
	62	+ * full_document bool May publish llms-full.txt, the full-content
	63	+ * companion document (thinkrank-pro#171).
	64	+ *
	65	+ * @since 2.5.0
	66	+ *
	67	+ * @return array Capability map.
74	68	*/
75		- public static function email_report(): array {
	69	+ public static function llms_txt(): array {
76	70	$defaults = [
77		- 'allowed_frequencies' => [30],
78		- 'max_recipients' => 1,
79		- 'recipients_locked_to' => 'admin_email',
80		- 'custom_subject' => false,
81		- 'custom_logo' => false,
82		- 'logo_link' => false,
83		- 'header_background' => false,
84		- 'link_to_full_report' => false,
85		- 'intro_text' => false,
86		- 'sections_configurable' => false,
87		- 'footer_text' => false,
88		- 'additional_css' => false,
89		- 'ai_highlights' => false,
	71	+ 'usage_policy' => false,
	72	+ 'full_document' => false,
90	73	];
91	74
92		- if (self::is_pro()) {
93		- $defaults = array_merge($defaults, [
94		- 'allowed_frequencies' => [7, 15, 30],
95		- 'max_recipients' => 50,
96		- 'recipients_locked_to' => null,
97		- 'custom_subject' => true,
98		- 'custom_logo' => true,
99		- 'logo_link' => true,
100		- 'header_background' => true,
101		- 'link_to_full_report' => true,
102		- 'intro_text' => true,
103		- 'sections_configurable' => true,
104		- 'footer_text' => true,
105		- 'additional_css' => true,
106		- // ai_highlights stays false by default — it's a separate sub-feature
107		- // the Pro plugin opts in to once the AI summary integration ships.
108		- ]);
109		- }
	75	+ /**
	76	+ * Filter the llms.txt capability map.
	77	+ *
	78	+ * ThinkRank Pro sets `usage_policy` to true; nothing in the free
	79	+ * plugin ever does, so the directives simply never render without it.
	80	+ *
	81	+ * @since 2.5.0
	82	+ *
	83	+ * @param array $defaults Capability map (see schema above).
	84	+ */
	85	+ $caps = apply_filters('thinkrank_llms_txt_capabilities', $defaults);
110	86
	87	+ return array_merge($defaults, is_array($caps) ? $caps : []);
	88	+ }
	89	+
	90	+ /**
	91	+ * Capability map for the Site SEO Analyzer.
	92	+ *
	93	+ * Running the audit and seeing the score is FREE and stays free. What Pro
	94	+ * adds is memory: dated snapshots of each run, a score trend, and a
	95	+ * side-by-side comparison of two runs (#161 in Pro). Free keeps exactly
	96	+ * what it has today — the most recent run, cached for an hour.
	97	+ *
	98	+ * Schema:
	99	+ * history bool May persist and read audit snapshots.
	100	+ * history_runs int Snapshots retained per site (0 = unlimited).
	101	+ *
	102	+ * @since 2.5.0
	103	+ *
	104	+ * @return array Capability map.
	105	+ */
	106	+ public static function seo_analyzer(): array {
	107	+ $defaults = [
	108	+ 'history' => false,
	109	+ 'history_runs' => 0,
	110	+ ];
	111	+
111	112	/**
112		- * Filter the Email Reporting capability map.
	113	+ * Filter the SEO Analyzer capability map.
113	114	*
114		- * The Pro plugin uses this filter (and only this filter) to enable
115		- * pro capabilities. Returning a partial array is fine; missing keys
116		- * fall back to the values above.
	115	+ * ThinkRank Pro sets `history` to true and declares how many runs it
	116	+ * retains. Nothing in the free plugin ever does, so no snapshot is
	117	+ * ever written without Pro.
117	118	*
118		- * @since 1.9.0
	119	+ * @since 2.5.0
119	120	*
120	121	* @param array $defaults Capability map (see schema above).
121	122	*/
122		- $caps = apply_filters('thinkrank_email_report_capabilities', $defaults);
	123	+ $caps = apply_filters('thinkrank_seo_analyzer_capabilities', $defaults);
123	124
124		- // Defensive merge: never let a filter drop required keys.
125	125	return array_merge($defaults, is_array($caps) ? $caps : []);
126	126	}
127	127
128	128	/**
129		- * Capability map for the Focus Keywords feature.
	129	+ * Capability map for Focus Pages.
130	130	*
131		- * Free allows up to 5 focus keywords; ThinkRank Pro lifts the cap. The 6th
132		- * and subsequent keywords are stored but only become usable (analyzed,
133		- * output, editable) once Pro raises the limit.
	131	+ * Focus Pages is Pro: it is bulk (many pages in one run), historical, and
	132	+ * depends on Pro-only rank data (thinkrank-pro#164). Free has no entry
	133	+ * point in v1 — the per-post SEO score panel already answers the single-page
	134	+ * on-page question.
134	135	*
135		- * Localized to the metabox as `thinkrankMetabox.focusKeywords`.
136	136	* Schema:
137		- * - max_keywords int Usable focus keywords. 0 = unlimited (Pro).
	137	+ * enabled bool May curate and diagnose focus pages.
	138	+ * max_pages int Pages that may be curated (0 = none).
138	139	*
139		- * @since 2.0.0
	140	+ * @since 2.5.0
140	141	*
141	142	* @return array Capability map.
142	143	*/
143		- public static function focus_keywords(): array {
144		- // Free default. ThinkRank Pro lifts the cap by filtering the map below
145		- // (Pro owns its own limit rather than the free plugin hard-coding it).
	144	+ public static function focus_pages(): array {
146	145	$defaults = [
147		- 'max_keywords' => 5,
	146	+ 'enabled' => false,
	147	+ 'max_pages' => 0,
148	148	];
149	149
150	150	/**
151		- * Filter the Focus Keywords capability map.
	151	+ * Filter the Focus Pages capability map.
152	152	*
153		- * The Pro plugin uses this filter to lift the free cap — set
154		- * `max_keywords` to 0 for unlimited, or a finite number.
	153	+ * ThinkRank Pro enables the feature and declares its own page cap,
	154	+ * which bounds the external API cost of a refresh.
155	155	*
156		- * @since 2.0.0
	156	+ * @since 2.5.0
157	157	*
158	158	* @param array $defaults Capability map (see schema above).
159	159	*/
160		- $caps = apply_filters('thinkrank_focus_keywords_capabilities', $defaults);
	160	+ $caps = apply_filters('thinkrank_focus_pages_capabilities', $defaults);
161	161
162	162	return array_merge($defaults, is_array($caps) ? $caps : []);
163	163	}
164	164
		@@ -164,16 +164,15 @@
164	164
165	165	/**
166	166	* Check a single capability for a given feature.
167	167	*
168		- * Currently only the `email_report` feature is registered. Adding more
169		- * features means adding a switch case here that delegates to its own
170		- * capability builder method.
	168	+ * Adding a feature means adding a switch case to capabilities_for() that
	169	+ * delegates to its own capability builder method.
171	170	*
172		- * @param string $capability Capability key (e.g. 'custom_subject').
173		- * @param string $feature Feature scope (default 'email_report').
	171	+ * @param string $capability Capability key (e.g. 'usage_policy').
	172	+ * @param string $feature Feature scope (e.g. 'llms_txt').
174	173	*/
175		- public static function can(string $capability, string $feature = 'email_report'): bool {
	174	+ public static function can(string $capability, string $feature): bool {
176	175	$caps = self::capabilities_for($feature);
177	176	return ! empty($caps[$capability]);
178	177	}
179	178
		@@ -184,51 +183,15 @@
184	183	* @return array
185	184	*/
186	185	public static function capabilities_for(string $feature): array {
187	186	switch ($feature) {
188		- case 'email_report':
189		- return self::email_report();
	187	+ case 'llms_txt':
	188	+ return self::llms_txt();
	189	+ case 'seo_analyzer':
	190	+ return self::seo_analyzer();
	191	+ case 'focus_pages':
	192	+ return self::focus_pages();
190	193	default:
191	194	return [];
192	195	}
193		- }
194		-
195		- /**
196		- * Clamp a frequency value to one the current plan allows.
197		- *
198		- * Free plans always end up at 30. Pro plans accept 7, 15, or 30.
199		- * Anything else falls back to the highest allowed value (most permissive
200		- * default that still respects the cap).
201		- *
202		- * @param int $requested Requested frequency in days.
203		- * @return int Clamped frequency.
204		- */
205		- public static function clamp_email_report_frequency(int $requested): int {
206		- $allowed = self::email_report()['allowed_frequencies'];
207		- if (in_array($requested, $allowed, true)) {
208		- return $requested;
209		- }
210		- return (int) max($allowed);
211		- }
212		-
213		- /**
214		- * Truncate a list of recipients to the plan-allowed maximum.
215		- *
216		- * Used at save and at render time. The save-time call gives the user
217		- * feedback; the render-time call is a defense in depth so a downgrade
218		- * never accidentally fans a report out to a list the user no longer
219		- * has the plan for.
220		- *
221		- * @param string[] $recipients Recipient email addresses.
222		- * @return string[] Truncated, de-duplicated recipients.
223		- */
224		- public static function clamp_email_report_recipients(array $recipients): array {
225		- $caps = self::email_report();
226		- $unique = array_values(array_unique(array_filter(array_map('trim', $recipients))));
227		-
228		- if ('admin_email' === $caps['recipients_locked_to']) {
229		- return [(string) get_option('admin_email')];
230		- }
231		-
232		- return array_slice($unique, 0, (int) $caps['max_recipients']);
233	196	}
234	197	}