wpsso / lib / messages-tooltip-meta-schema.php

messages-tooltip-meta-schema.php in WPSSO Core – Complete Schema Markup and Meta Tags 22.7.0, at lib/messages-tooltip-meta-schema.php

1,138 lines 39.9 KB

Raw Download Zip

1	<?php
2	/*
3	* License: GPLv3
4	* License URI: https://www.gnu.org/licenses/gpl.txt
5	* Copyright 2012-2026 Jean-Sebastien Morisset (https://wpsso.com/)
6	*/
7
8	if ( ! defined( 'ABSPATH' ) ) {
9
10	die( 'These aren\'t the droids you\'re looking for.' );
11	}
12
13	if ( ! defined( 'WPSSO_PLUGINDIR' ) ) {
14
15	die( 'Do. Or do not. There is no try.' );
16	}
17
18	if ( ! class_exists( 'WpssoMessagesTooltipMetaSchema' ) ) {
19
20	/*
21	* Instantiated by WpssoMessagesTooltipMeta->get() only when needed.
22	*/
23	class WpssoMessagesTooltipMetaSchema extends WpssoMessages {
24
25	public function get( $msg_key = false, $info = array() ) {
26
27	$this->maybe_set_properties();
28
29	$text = '';
30
31	switch ( $msg_key ) {
32
33	/*
34	* Document SSO > Edit Schema tab.
35	*/
36	case 'tooltip-meta-schema_title': // Name.
37
38	$text = __( 'A customized name (aka title) for the Schema "name" property.', 'wpsso' ) . ' ';
39
40	$text .= __( 'The default value is inherited from the SEO title.', 'wpsso' ) . ' ';
41
42	$text .= sprintf( __( 'You may use the <code>%1$s</code> and/or <code>%2$s</code> filters to modify the default and custom values respectively.', 'wpsso' ), 'wpsso_the_title', 'wpsso_title' ) . ' ';
43
44	break;
45
46	case 'tooltip-meta-schema_title_alt': // Alternate Name.
47
48	$text = __( 'A customized alternate name (aka title) for the Schema "alternateName" property.', 'wpsso' ) . ' ';
49
50	$text .= __( 'The default value is inherited from the Schema name or SEO title.', 'wpsso' ) . ' ';
51
52	$text .= sprintf( __( 'You may use the <code>%1$s</code> and/or <code>%2$s</code> filters to modify the default and custom values respectively.', 'wpsso' ), 'wpsso_the_title', 'wpsso_title' ) . ' ';
53
54	break;
55
56	case 'tooltip-meta-schema_title_bc': // Breadcrumb Name.
57
58	$text = __( 'A short title used for the Schema and/or HTML breadcrumb item name.', 'wpsso' ) . ' ';
59
60	$text .= __( 'The default value is inherited from the Schema alternate name, Schema name, or SEO title.', 'wpsso' ) . ' ';
61
62	$text .= sprintf( __( 'You may use the <code>%1$s</code> and/or <code>%2$s</code> filters to modify the default and custom values respectively.', 'wpsso' ), 'wpsso_the_title', 'wpsso_title' ) . ' ';
63
64	break;
65
66	case 'tooltip-meta-schema_desc': // Description.
67
68	$text = __( 'A customized description for the Schema "description" property.', 'wpsso' ) . ' ';
69
70	$text .= __( 'The default value is inherited from the SEO description.', 'wpsso' ) . ' ';
71
72	$text .= sprintf( __( 'You may use the <code>%1$s</code> and/or <code>%2$s</code> filters to modify the default and custom values respectively.', 'wpsso' ), 'wpsso_the_description', 'wpsso_description' ) . ' ';
73
74	break;
75
76	case 'tooltip-meta-schema_lang': // Language.
77
78	$text = __( 'The language (aka locale) of this webpage.', 'wpsso' ) . ' ';
79
80	$text .= sprintf( __( 'You may use the <code>%1$s</code> and/or <code>%2$s</code> filters to modify the default and custom values respectively.', 'wpsso' ), 'sucom_get_locale', 'wpsso_schema_lang' ) . ' ';
81
82	break;
83
84	case 'tooltip-meta-schema_addl_type_url': // Microdata Type URLs.
85
86	$tp_frags = $this->get_tooltip_fragments( 'addl_type_urls' ); // Uses a local cache.
87
88	$text = __( 'Additional microdata type URL(s) for the content, typically used to specify more precise type(s) from an external vocabulary.', 'wpsso' ) . ' ';
89
90	$text .= sprintf( __( 'For example, an additional microdata type URL for a Schema Product type could be %1$s (see %2$s for more examples).', 'wpsso' ), 'http://www.productontology.org/id/Hammer', __( '<a href="http://www.productontology.org/">The Product Types Ontology</a>', 'wpsso' ) ) . ' ';
91
92	if ( ! empty( $tp_frags[ 'filter' ] ) ) { // Just in case.
93
94	$text .= sprintf( __( 'You may use the <code>%s</code> filter to modify the custom values.', 'wpsso' ), $tp_frags[ 'filter' ] ) . ' ';
95	}
96
97	break;
98
99	case 'tooltip-meta-schema_sameas_url': // Same-As URLs.
100
101	$tp_frags = $this->get_tooltip_fragments( 'sameas_urls' ); // Uses a local cache.
102
103	$text = __( 'Additional webpage reference URL(s) that unambiguously indicates the content\'s identity.', 'wpsso' ) . ' ';
104
105	$text .= __( 'For example, the URL for the content subject\'s Wikipedia page, Wikidata entry, IMDB page, official website, etc.', 'wpsso' ) . ' ';
106
107	if ( ! empty( $tp_frags[ 'filter' ] ) ) { // Just in case.
108
109	$text .= sprintf( __( 'You may use the <code>%s</code> filter to modify the custom values.', 'wpsso' ), $tp_frags[ 'filter' ] ) . ' ';
110	}
111
112	break;
113
114	case 'tooltip-meta-schema_headline': // Headline.
115
116	$text = __( 'The headline for this creative work.', 'wpsso' ) . ' ';
117
118	$text .= __( 'The default value is inherited from the Schema name, alternate name, or the SEO title.', 'wpsso' ) . ' ';
119
120	$text .= sprintf( __( 'You may use the <code>%1$s</code> and/or <code>%2$s</code> filters to modify the default and custom values respectively.', 'wpsso' ), 'wpsso_the_title', 'wpsso_title' ) . ' ';
121
122	break;
123
124	case 'tooltip-meta-schema_text': // Full Text.
125
126	$text = __( 'The complete textual and searchable content for this creative work.', 'wpsso' ) . ' ';
127
128	$text .= __( 'The default value is the current object (for example, the post/page) content text with shortcodes and blocks expanded and HTML removed.', 'wpsso' ) . ' ';
129
130	$text .= sprintf( __( 'You may use the <code>%1$s</code> and/or <code>%2$s</code> filters to modify the default and custom values respectively.', 'wpsso' ), 'wpsso_the_text', 'wpsso_text' ) . ' ';
131
132	break;
133
134	case 'tooltip-meta-schema_keywords_csv': // Keywords.
135
136	$text = __( 'A comma delimited list of keywords or tags describing the creative work.', 'wpsso' );
137
138	break;
139
140	case 'tooltip-meta-schema_family_friendly': // Family Friendly.
141
142	$text = __( 'The content of this creative work is family friendly.', 'wpsso' );
143
144	break;
145
146	case 'tooltip-meta-schema_copyright_year': // Copyright Year.
147
148	$text = __( 'The year during which the claimed copyright was first asserted for this creative work.', 'wpsso' );
149
150	break;
151
152	case 'tooltip-meta-schema_license_url': // License URL.
153
154	$text = __( 'A license document URL that applies to this creative work.', 'wpsso' );
155
156	break;
157
158	case 'tooltip-meta-schema_pub_org_id': // Publisher Organization.
159	case 'tooltip-meta-schema_pub_person_id': // Publisher Person.
160
161	$text = __( 'A publisher for this creative work.', 'wpsso' );
162
163	break;
164
165	case 'tooltip-meta-schema_prov_org_id': // Provider Organization.
166	case 'tooltip-meta-schema_prov_person_id': // Provider Person.
167
168	$text = __( 'A service provider, service operator, or service performer.', 'wpsso' );
169
170	break;
171
172	case 'tooltip-meta-schema_fund_org_id': // Funder Organization.
173	case 'tooltip-meta-schema_fund_person_id': // Funder Person.
174
175	$text = __( 'A funder that supports (sponsors) this creative work through somekind of financial contribution.', 'wpsso' );
176
177	break;
178
179	case 'tooltip-meta-schema_ispartof_url': // Is Part of URLs.
180
181	$text = __( 'URLs to other creative works that this content is a part of.', 'wpsso' );
182
183	break;
184
185	case 'tooltip-meta-schema_award': // Creative Work Awards.
186
187	$text = __( 'Awards this creative work has won.', 'wpsso' );
188
189	break;
190
191	case 'tooltip-meta-schema_citation': // Reference Citations.
192
193	$text = __( 'Reference citations to creative works, such as other publications, web pages, scholarly articles, etc.', 'wpsso' ) . ' ';
194
195	$text .= sprintf( __( 'You can find <a href="%1$s">information on writing citations from Google</a> or one of many articles on <a href="%2$s">How to Make a Citation in MLA, APA, and Chicago/Turabian</a>.', 'wpsso' ),
196	__( 'https://www.google.com/search?q=how+to+write+a+citation', 'wpsso' ),
197	__( 'https://www.bibliography.com/how-to/how-to-make-a-citation/', 'wpsso' ) );
198
199	break;
200
201	case 'tooltip-meta-schema_article_section': // Article Section.
202
203	$option_link = $this->p->util->get_admin_url( 'advanced#sucom-tabset_schema_defs-tab_article',
204	_x( 'Default Article Section', 'option label', 'wpsso' ) );
205
206	$tp_frags = $this->get_tooltip_fragments( preg_replace( '/^tooltip-meta-schema_/', '', $msg_key ) ); // Uses a local cache.
207
208	$text = sprintf( __( 'A custom value for the %1$s, which may be different than the %2$s option value.', 'wpsso' ),
209	$tp_frags[ 'name' ], $option_link ) . ' ';
210
211	$text .= sprintf( __( 'Select "[None]" to exclude the %s from Schema markup and meta tags.', 'wpsso' ),
212	$tp_frags[ 'name' ] ) . ' ';
213
214	if ( ! empty( $tp_frags[ 'about' ] ) ) {
215
216	// translators: %1$s is a webpage URL and %2$s is a singular item reference, for example 'a product Google category'.
217	$text .= sprintf( __( '<a href="%1$s">See this webpage for more information about choosing %2$s value</a>.',
218	'wpsso' ), $tp_frags[ 'about' ], $tp_frags[ 'desc' ] ) . ' ';
219	}
220
221	if ( ! empty( $tp_frags[ 'inherit' ] ) ) {
222
223	$text .= sprintf( __( 'Note that the %s value is automatically inherited as a default value by any child pages.',
224	'wpsso' ), $tp_frags[ 'name' ] ) . ' ';
225	}
226
227	break;
228
229	case 'tooltip-meta-schema_reading_mins': // Est. Reading Time.
230
231	$text = __( 'The estimated reading time (in minutes) for this article.', 'wpsso' ) . ' ';
232
233	$text .= __( 'A value of 0 minutes excludes the estimated reading time from Schema markup and meta tags.', 'wpsso' );
234
235	break;
236
237	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_book_' ) ? true : false ):
238
239	switch ( $msg_key ) {
240
241	case 'tooltip-meta-schema_book_author_type': // Book Author Type.
242
243	$text .= __( 'The creative work author can be a person or an organization.', 'wpsso' );
244
245	break;
246
247	case 'tooltip-meta-schema_book_author_name': // Book Author Name.
248
249	$text = __( 'Enter the name of the author for this creative work.', 'wpsso' ) . ' ';
250
251	break;
252
253	case 'tooltip-meta-schema_book_author_url': // Book Author URL.
254
255	$text = __( 'The home page of the author, or another definitive URL that provides information about the author, such as the person or organization\'s Wikipedia or Wikidata page.', 'wpsso' );
256
257	break;
258
259	case 'tooltip-meta-schema_book_pub': // Book Published Date.
260
261	$text = __( 'The date when this creative work was published or entered public discourse.', 'wpsso' );
262
263	break;
264
265	case 'tooltip-meta-schema_book_created': // Book Created Date.
266
267	$text = __( 'The date when this creative work was created.', 'wpsso' );
268
269	break;
270
271	case 'tooltip-meta-schema_book_edition': // Book Edition.
272
273	$text = __( 'The edition of the book.', 'wpsso' );
274
275	break;
276
277	case 'tooltip-meta-schema_book_format': // Book Format.
278
279	$text = __( 'The publication format of the book.', 'wpsso' );
280
281	break;
282
283	case 'tooltip-meta-schema_book_pages': // Book Pages.
284
285	$text = __( 'The number of pages in the book.', 'wpsso' );
286
287	break;
288
289	case 'tooltip-meta-schema_book_isbn': // Book ISBN.
290
291	$text = __( 'The ISBN code (aka International Standard Book Number) of the book.', 'wpsso' );
292
293	break;
294
295	case 'tooltip-meta-schema_book_offers': // Book Offers.
296
297	$text = __( 'One or more offers for the book, including the offer name, price and currency.', 'wpsso' );
298
299	break;
300
301	case 'tooltip-meta-schema_book_audio_duration_time': // Audiobook Duration.
302
303	$text = __( 'The total duration of the audio book.', 'wpsso' );
304
305	break;
306
307	} // End of 'tooltip-meta-schema_book' switch.
308
309	break; // End of 'tooltip-meta-schema_book' case.
310
311	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_event_' ) ? true : false ):
312
313	switch ( $msg_key ) {
314
315	case 'tooltip-meta-schema_event_lang': // Event Language.
316
317	$text = __( 'The language (aka locale) for the event performance.', 'wpsso' );
318
319	break;
320
321	case 'tooltip-meta-schema_event_attendance': // Event Attendance.
322
323	$text = __( 'Select if the event occurs online, offline at a physical location, or a mix of both online and offline.', 'wpsso' );
324
325	break;
326
327	case 'tooltip-meta-schema_event_online_url': // Event Online URL.
328
329	$text = __( 'An online or virtual location URL to attend the event.', 'wpsso' );
330
331	break;
332
333	case 'tooltip-meta-schema_event_location_id': // Event Venue.
334
335	$text = __( 'Select a physical venue for the event.', 'wpsso' );
336
337	break;
338
339	case 'tooltip-meta-schema_event_performer_org_id': // Performer Organization.
340	case 'tooltip-meta-schema_event_performer_person_id': // Performer Person.
341
342	$text = __( 'Select a performer for the event.', 'wpsso' );
343
344	break;
345
346	case 'tooltip-meta-schema_event_organizer_org_id': // Organizer Organization.
347	case 'tooltip-meta-schema_event_organizer_person_id': // Organizer Person.
348
349	$text = __( 'Select an organizer for the event.', 'wpsso' );
350
351	break;
352
353	case 'tooltip-meta-schema_event_fund_org_id': // Funder Organization.
354	case 'tooltip-meta-schema_event_fund_person_id': // Funder Person.
355
356	$text = __( 'Select a funder that supports (sponsors) the event through somekind of financial contribution.', 'wpsso' );
357
358	break;
359
360	case 'tooltip-meta-schema_event_status': // Event Status.
361
362	// translators: Please ignore - translation uses a different text domain.
363	$cancelled = _x( 'Cancelled', 'option value', 'wpsso' );
364
365	// translators: Please ignore - translation uses a different text domain.
366	$postponed = _x( 'Postponed', 'option value', 'wpsso' );
367
368	// translators: Please ignore - translation uses a different text domain.
369	$rescheduled = _x( 'Rescheduled', 'option value', 'wpsso' );
370
371	$text = __( 'Select the event status (default is Scheduled).', 'wpsso' ) . ' ';
372
373	// translators: %s is the "Cancelled" event status.
374	$text .= sprintf( __( 'If you select %s, do not change the original event start date.',
375	'wpsso' ), $cancelled ) . ' ';
376
377	// translators: %s is the "Postponed" event status.
378	$text .= sprintf( __( 'If you select %s (but the rescheduled date isn\'t known yet), do not change the original event start date.',
379	'wpsso' ), $postponed ) . ' ';
380
381	// translators: %s is the "Rescheduled" event status.
382	$text .= sprintf( __( 'If you select %s, update the previous start date option, then change the original start and end dates.',
383	'wpsso' ), $rescheduled ) . ' ';
384
385	break;
386
387	case 'tooltip-meta-schema_event_start': // Event Start.
388
389	$text = __( 'Select the event start date and time.', 'wpsso' );
390
391	break;
392
393	case 'tooltip-meta-schema_event_end': // Event End.
394
395	$text = __( 'Select the event end date and time.', 'wpsso' );
396
397	break;
398
399	case 'tooltip-meta-schema_event_previous': // Event Previous Start.
400
401	$text = __( 'The previously scheduled start date for the event, if the event has been rescheduled.', 'wpsso' );
402
403	break;
404
405	case 'tooltip-meta-schema_event_offers': // Event Offers.
406
407	$text = __( 'One or more offers for the event, including the offer name, price and currency.', 'wpsso' );
408
409	break;
410
411	case 'tooltip-meta-schema_event_offers_start': // Event Offers Start.
412
413	$text = __( 'The date and time when tickets go on sale.', 'wpsso' );
414
415	break;
416
417	case 'tooltip-meta-schema_event_offers_end': // Event Offers End.
418
419	$text = __( 'The date and time when tickets are no longer on sale.', 'wpsso' );
420
421	break;
422
423	} // End of 'tooltip-meta-schema_event' switch.
424
425	break; // End of 'tooltip-meta-schema_event' case.
426
427	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_howto_' ) ? true : false ):
428
429	switch ( $msg_key ) {
430
431	case 'tooltip-meta-schema_howto_steps': // How-To Steps.
432
433	$text = __( 'A list of steps for this How-To, including the How-To step name and (optional) longer How-To step description.', 'wpsso' ) . ' ';
434
435	$text .= __( 'You can also (optionally) define How-To sections to group individual steps together.', 'wpsso' );
436
437	break;
438
439	case 'tooltip-meta-schema_howto_supplies': // How-To Supplies
440
441	$text = __( 'A list of supplies that are consumed when completing this How-To.', 'wpsso' );
442
443	break;
444
445	case 'tooltip-meta-schema_howto_tools': // How-To Tools
446
447	$text = __( 'A list of tools or objects that are required to complete this How-To.', 'wpsso' );
448
449	break;
450
451	case 'tooltip-meta-schema_howto_prep_time': // Preparation Time.
452
453	$text = __( 'The total time it takes to prepare the items before executing the instruction steps.', 'wpsso' );
454
455	break;
456
457	case 'tooltip-meta-schema_howto_total_time': // Total Time.
458
459	$text = __( 'The total time required to perform the all instructions (including any preparation time).', 'wpsso' );
460
461	break;
462
463	case 'tooltip-meta-schema_howto_yield':
464
465	$text = __( 'The quantity made when following these How-To instructions (example: "a paper airplane", "10 personalized candles", etc.).', 'wpsso' );
466
467	break;
468
469	} // End of 'tooltip-meta-schema_howto' switch.
470
471	break; // End of 'tooltip-meta-schema_howto' case.
472
473	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_job_' ) ? true : false ):
474
475	switch ( $msg_key ) {
476
477	case 'tooltip-meta-schema_job_title': // Job Title.
478
479	$text = __( 'The title of this job, which may be different than the WordPress post/page title.', 'wpsso' );
480
481	break;
482
483	case 'tooltip-meta-schema_job_hiring_org_id': // Job Hiring Organization.
484
485	$text = __( 'Select a organization for the Schema JobPosting hiring organization.', 'wpsso' );
486
487	break;
488
489	case 'tooltip-meta-schema_job_location_id': // Job Location.
490
491	$text = __( 'Select a location for the Schema JobPosting job location.', 'wpsso' );
492
493	break;
494
495	case 'tooltip-meta-schema_job_location_type': // Job Location Type.
496
497	$text = sprintf( __( 'Select an optional Google approved location type (see <a href="%s">Google\'s Job Posting guidelines</a> for more information).', 'wpsso' ), 'https://developers.google.com/search/docs/appearance/structured-data/job-posting' );
498
499	break;
500
501	case 'tooltip-meta-schema_job_salary': // Job Base Salary.
502
503	$text = __( 'Optionally provide details on the base salary.', 'wpsso' );
504
505	$text .= __( 'The base salary must be numeric, like 120000, 50.00, etc.', 'wpsso' );
506
507	$text .= __( 'Do not use spaces, commas, or currency symbols, as these are not valid numeric values.', 'wpsso' );
508
509	break;
510
511	case 'tooltip-meta-schema_job_empl_type': // Job Employment Type.
512
513	$text = sprintf( __( 'Check one or more Google approved employment types (see <a href="%s">Google\'s Job Posting guidelines</a> for more information).', 'wpsso' ), 'https://developers.google.com/search/docs/appearance/structured-data/job-posting' );
514
515	break;
516
517	case 'tooltip-meta-schema_job_expire': // Job Posting Expires.
518
519	$text = __( 'Select a job posting expiration date and time.', 'wpsso' );
520
521	$text .= __( 'If a job posting never expires, or you do not know when the job will expire, do not select an expiration date and time.', 'wpsso' );
522
523	break;
524
525	} // End of 'tooltip-meta-schema_job' switch.
526
527	break; // End of 'tooltip-meta-schema_job' case.
528
529	/*
530	* Schema CreativeWork > LearningResource.
531	*
532	* See https://developers.google.com/search/docs/appearance/structured-data/learning-video#learning-video-[videoobject,-learningresource].
533	*/
534	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_learnres_' ) ? true : false ):
535
536	switch ( $msg_key ) {
537
538	case 'tooltip-meta-schema_learnres_educational_level': // Educational Level.
539
540	$text = __( 'The target education level for the learning resource.', 'wpsso' ) . ' ';
541
542	$text .= __( 'Select a country-specific education level or one of the generic values.', 'wpsso' );
543
544	break;
545
546	case 'tooltip-meta-schema_learnres_resource_type': // Resource Type.
547
548	$text = __( 'The predominant type or kind characterizing the learning resource (example: "Concept overview", "Problem walkthrough", "Real life example", "Activity", "Experiment", "Lecture", etc.).', 'wpsso' );
549
550	break;
551
552	} // End of 'tooltip-meta-schema_learnres' switch.
553
554	break; // End of 'tooltip-meta-schema_learnres' case.
555
556	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_movie_' ) ? true : false ):
557
558	switch ( $msg_key ) {
559
560	case 'tooltip-meta-schema_movie_actor_person_names': // Cast Names.
561
562	$text = __( 'The name of one or more actors appearing in the movie.', 'wpsso' );
563
564	break;
565
566	case 'tooltip-meta-schema_movie_director_person_names': // Director Names.
567
568	$text = __( 'The name of one or more directors of the movie.', 'wpsso' );
569
570	break;
571
572	case 'tooltip-meta-schema_movie_prodco_org_id': // Movie Production Company.
573
574	$text = __( 'The principle production company or studio responsible for the movie.', 'wpsso' );
575
576	break;
577
578	case 'tooltip-meta-schema_movie_released': // Movie Release Date.
579
580	$text = __( 'The date the movie was released.', 'wpsso' );
581
582	break;
583
584	case 'tooltip-meta-schema_movie_duration_time': // Movie Runtime.
585
586	$text = __( 'The total movie runtime from the start to the end of the credits.', 'wpsso' );
587
588	break;
589
590	} // End of 'tooltip-meta-schema_movie' switch.
591
592	break; // End of 'tooltip-meta-schema_movie' case.
593
594	case 'tooltip-meta-schema_organization_id':
595
596	$text = __( 'Select an organization for the Schema Organization markup.', 'wpsso' );
597
598	break;
599
600	case 'tooltip-meta-schema_person_id':
601
602	$role_label_transl = _x( 'Person', 'user role', 'wpsso' );
603
604	$text = __( 'Select a person for the Schema Person markup.', 'wpsso' ) . ' ';
605
606	$text .= sprintf( __( 'A user must be member of the WordPress "%s" role to be included in this list.', 'wpsso' ), $role_label_transl );
607
608	break;
609
610	case 'tooltip-meta-schema_place_id':
611
612	$text = __( 'Select a place for the Schema Place markup, or enter custom place information below.', 'wpsso' );
613
614	break;
615
616	case 'tooltip-meta-schema_profile_person_id':
617
618	$role_label_transl = _x( 'Person', 'user role', 'wpsso' );
619
620	$text = __( 'Select a person for the Schema ProfilePage markup.', 'wpsso' ) . ' ';
621
622	$text .= sprintf( __( 'A user must be member of the WordPress "%s" role to be included in this list.', 'wpsso' ), $role_label_transl );
623
624	break;
625
626	case 'tooltip-meta-schema_qa_desc':
627
628	$text = __( 'An optional heading / description of the question and it\'s answer.', 'wpsso' ) . ' ';
629
630	$text .= __( 'If the question is part of a larger group of questions on the same subject, then this would be an appropriate field to describe that subject (example: "QA about a Flying Toaster" ).', 'wpsso' );
631
632	break;
633
634	/*
635	* Schema CreativeWork > HowTo > Recipe.
636	*/
637	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_recipe_' ) ? true : false ):
638
639	switch ( $msg_key ) {
640
641	case 'tooltip-meta-schema_recipe_cuisine': // Recipe Cuisine.
642
643	$text = __( 'The type of cuisine for this recipe (example: French, Indian, Italian, Japanese, Thai, etc.).', 'wpsso' );
644
645	break;
646
647	case 'tooltip-meta-schema_recipe_course': // Recipe Course.
648
649	$text = __( 'The course name for this recipe (example: Appetizer, Entrée, Main Course / Main Dish, Dessert, Side-dish, etc.).', 'wpsso' );
650
651	break;
652
653	case 'tooltip-meta-schema_recipe_yield': // Recipe Makes.
654
655	$text = __( 'The quantity or servings made by this recipe (example: "5 servings", "Serves 4-6", "Yields 10 burgers", etc.).', 'wpsso' );
656
657	break;
658
659	case 'tooltip-meta-schema_recipe_cook_method': // Cooking Method.
660
661	$text = __( 'The cooking method used for this recipe (example: Baking, Frying, Steaming, etc.)', 'wpsso' );
662
663	break;
664
665	case 'tooltip-meta-schema_recipe_prep_time': // Preparation Time.
666
667	$text = $this->p->msgs->get( 'tooltip-meta-schema_howto_prep_time' );
668
669	break;
670
671	case 'tooltip-meta-schema_recipe_cook_time': // Cooking Time.
672
673	$text = __( 'The total time it takes to cook this recipe.', 'wpsso' );
674
675	break;
676
677	case 'tooltip-meta-schema_recipe_total_time': // Total Time.
678
679	$text = $this->p->msgs->get( 'tooltip-meta-schema_howto_total_time' );
680
681	break;
682
683	case 'tooltip-meta-schema_recipe_ingredients': // Recipe Ingredients.
684
685	$text = __( 'A list of ingredients for this recipe (example: "1 cup flour", "1 tsp salt", etc.).', 'wpsso' );
686
687	break;
688
689	case 'tooltip-meta-schema_recipe_instructions': // Recipe Instructions.
690
691	$text = __( 'A list of instructions for this recipe, including the instruction name (example: "beat eggs", "add and mix flour", etc.) and (optional) longer instruction description.', 'wpsso' ) . ' ';
692
693	$text .= __( 'You can also (optionally) define recipe instruction sections to group individual instructions together.', 'wpsso' );
694
695	break;
696
697	case 'tooltip-meta-schema_recipe_nutri_serv': // Serving Size.
698
699	$text = __( 'The serving size in volume or mass. A serving size is required to include nutrition information in the Schema recipe markup.', 'wpsso' );
700
701	break;
702
703	case 'tooltip-meta-schema_recipe_nutri_cal': // Calories.
704
705	$text = __( 'The number of calories per serving.', 'wpsso' );
706
707	break;
708
709	case 'tooltip-meta-schema_recipe_nutri_prot': // Protein.
710
711	$text = __( 'The number of grams of protein per serving.', 'wpsso' );
712
713	break;
714
715	case 'tooltip-meta-schema_recipe_nutri_fib': // Fiber.
716
717	$text = __( 'The number of grams of fiber per serving.', 'wpsso' );
718
719	break;
720
721	case 'tooltip-meta-schema_recipe_nutri_carb': // Carbohydrates.
722
723	$text = __( 'The number of grams of carbohydrates per serving.', 'wpsso' );
724
725	break;
726
727	case 'tooltip-meta-schema_recipe_nutri_sugar': // Sugar.
728
729	$text = __( 'The number of grams of sugar per serving.', 'wpsso' );
730
731	break;
732
733	case 'tooltip-meta-schema_recipe_nutri_sod': // Sodium.
734
735	$text = __( 'The number of milligrams of sodium per serving.', 'wpsso' );
736
737	break;
738
739	case 'tooltip-meta-schema_recipe_nutri_fat': // Fat.
740
741	$text = __( 'The number of grams of fat per serving.', 'wpsso' );
742
743	break;
744
745	case 'tooltip-meta-schema_recipe_nutri_sat_fat': // Saturated Fat.
746
747	$text = __( 'The number of grams of saturated fat per serving.', 'wpsso' );
748
749	break;
750
751	case 'tooltip-meta-schema_recipe_nutri_unsat_fat': // Unsaturated Fat.
752
753	$text = __( 'The number of grams of unsaturated fat per serving.', 'wpsso' );
754
755	break;
756
757	case 'tooltip-meta-schema_recipe_nutri_trans_fat': // Trans Fat.
758
759	$text = __( 'The number of grams of trans fat per serving.', 'wpsso' );
760
761	break;
762
763	case 'tooltip-meta-schema_recipe_nutri_chol': // Cholesterol.
764
765	$text = __( 'The number of milligrams of cholesterol per serving.', 'wpsso' );
766
767	break;
768
769	} // End of 'tooltip-meta-schema_recipe' switch.
770
771	break; // End of 'tooltip-meta-schema_recipe' case.
772
773	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_review_' ) ? true : false ):
774
775	switch ( $msg_key ) {
776
777	case 'tooltip-meta-schema_review_rating': // Review: Review Rating
778
779	$text = __( 'A rating for the subject or item being reviewed, along with the low / high rating scale (default is 1 to 5).', 'wpsso' ) . ' ';
780
781	$text .= __( 'If you are reviewing a claim, the following rating scale is used: 1 = False, 2 = Mostly false, 3 = Half true, 4 = Mostly true, 5 = True.', 'wpsso' ) . ' ';
782
783	break;
784
785	case 'tooltip-meta-schema_review_rating_alt_name': // Review: Rating Alt Name
786
787	$tp_frags = $this->get_tooltip_fragments( preg_replace( '/^tooltip-meta-schema_/', '', $msg_key ) ); // Uses a local cache.
788
789	$text = __( 'An alternate name for the rating value (example: False, Misleading, Accurate, etc.).', 'wpsso' ) . ' ';
790
791	// translators: %1$s is a webpage URL and %2$s is a singular item reference, for example 'a product Google category'.
792	$text .= sprintf( __( '<a href="%1$s">See this webpage for more information about choosing %2$s value</a>.',
793	'wpsso' ), $tp_frags[ 'about' ], $tp_frags[ 'desc' ] ) . ' ';
794
795	break;
796
797	case 'tooltip-meta-schema_review_item_name': // Review: Subject Name.
798
799	$text = __( 'A name for the subject or item being reviewed.', 'wpsso' );
800
801	break;
802
803	case 'tooltip-meta-schema_review_item_desc': // Review: Subject Description.
804
805	$text = __( 'A description for the subject or item being reviewed.', 'wpsso' );
806
807	break;
808
809	case 'tooltip-meta-schema_review_item_img_id': // Review: Subject Image ID.
810
811	$text = __( 'An image ID showing the subject or item being reviewed.', 'wpsso' ) . ' ';
812
813	$text .= '<em>' . __( 'This option is disabled if a subject image URL is entered.', 'wpsso' ) . '</em>';
814
815	break;
816
817	case 'tooltip-meta-schema_review_item_img_url': // Review: Subject Image URL.
818
819	$text = __( 'An image URL (instead of an image ID) showing the subject or item being reviewed.', 'wpsso' ) . ' ';
820
821	$text .= '<em>' . __( 'This option is disabled if a subject image ID is selected.', 'wpsso' ) . '</em>';
822
823	break;
824
825	case 'tooltip-meta-schema_review_item_url': // Review: Subject Webpage URL.
826
827	$text = __( 'A webpage URL for the subject or item being reviewed.', 'wpsso' );
828
829	break;
830
831	case 'tooltip-meta-schema_review_item_sameas_url': // Review: Subject Same-As URL.
832
833	$text = $this->p->msgs->get( 'tooltip-meta-schema_sameas_url' );
834
835	break;
836
837	case 'tooltip-meta-schema_review_item_type': // Review: Subject Schema Type.
838
839	$text = __( 'A Schema type for the subject or item being reviewed (for example, Schema Product type for the review of a product, Schema Book for the review of a book, etc.).', 'wpsso' ) . ' ';
840
841	$text .= sprintf( __( 'Although the Schema standard allows the subject of a review (aka the item reviewed) to be any Schema type, <a href="%1$s">Google only allows reviews for a few specific Schema types (and their sub-types)</a>.', 'wpsso' ), 'https://developers.google.com/search/docs/data-types/review-snippet' );
842
843	break;
844
845	/*
846	* Schema Review Subject: Creative Work.
847	*/
848	case 'tooltip-meta-schema_review_item_cw_author_type': // Review: Subject Author Type.
849
850	$text .= __( 'The creative work author can be a person or an organization.', 'wpsso' );
851
852	break;
853
854	case 'tooltip-meta-schema_review_item_cw_author_name': // Review: Subject Author Name.
855
856	$text = __( 'Enter the name of the author for this creative work.', 'wpsso' ) . ' ';
857
858	break;
859
860	case 'tooltip-meta-schema_review_item_cw_author_url': // Review: Subject Author URL.
861
862	$text = __( 'The home page of the author, or another definitive URL that provides information about the author, such as the person or organization\'s Wikipedia or Wikidata page.', 'wpsso' );
863
864	break;
865
866	case 'tooltip-meta-schema_review_item_cw_pub': // Review: Subject Published Date.
867
868	$text = __( 'The date when this creative work was published or entered public discourse.', 'wpsso' );
869
870	break;
871
872	case 'tooltip-meta-schema_review_item_cw_created': // Review: Subject Created Date.
873
874	$text = __( 'The date when this creative work was created.', 'wpsso' );
875
876	break;
877
878	/*
879	* Schema Review Subject: Creative Work / Book.
880	*/
881	case 'tooltip-meta-schema_review_item_cw_book_isbn': // Review: Subject Book ISBN.
882
883	$text = __( 'The ISBN code (aka International Standard Book Number) for the book being reviewed.', 'wpsso' );
884
885	break;
886
887	/*
888	* Schema Review Subject: Creative Work / Movie.
889	*/
890	case 'tooltip-meta-schema_review_item_cw_movie_actor_person_names': // Review: Movie Cast Names.
891
892	$text = $this->p->msgs->get( 'tooltip-meta-schema_movie_actor_person_names' );
893
894	break;
895
896	case 'tooltip-meta-schema_review_item_cw_movie_director_person_names': // Review: Movie Director Names.
897
898	$text = $this->p->msgs->get( 'tooltip-meta-schema_movie_director_person_names' );
899
900	break;
901
902	/*
903	* Schema Review Subject: Product.
904	*/
905	case 'tooltip-meta-schema_review_item_product_brand': // Review: Subject Product Brand.
906
907	$text = __( 'The brand name of the product being reviewed.', 'wpsso' );
908
909	break;
910
911	case 'tooltip-meta-schema_review_item_product_offers': // Review: Subject Product Offers.
912
913	$text = __( 'One or more offers for the product being reviewed, including the offer name, price and currency.', 'wpsso' );
914
915	break;
916
917	case 'tooltip-meta-schema_review_item_product_retailer_part_no': // Review: Subject Product SKU.
918
919	$text = __( 'The SKU (aka Stock-Keeping Unit) of the product being reviewed.', 'wpsso' );
920
921	break;
922
923	case 'tooltip-meta-schema_review_item_product_mfr_part_no': // Review: Subject Product MPN.
924
925	$text = __( 'The MPN (aka Manufacturer Part Number) of the product being reviewed.', 'wpsso' );
926
927	break;
928
929	/*
930	* Schema Review Subject: Software Application.
931	*/
932	case 'tooltip-meta-schema_review_item_software_app_offers': // Review: Software App Offers.
933
934	$text = __( 'One or more offers for the software application being reviewed, including the offer name, price and currency.', 'wpsso' );
935
936	break;
937
938	/*
939	* Schema Claim Review.
940	*/
941	case 'tooltip-meta-schema_review_claim_reviewed': // Short Summary of Claim
942
943	$text = __( 'A short summary of specific claim(s) being reviewed in the Schema ClaimReview content.', 'wpsso' ) . ' ';
944
945	$text .= __( 'The summary should be less than 75 characters to minimize wrapping on mobile devices.', 'wpsso' );
946
947	break;
948
949	case 'tooltip-meta-schema_review_claim_first_url': // First Appearance URL
950
951	$text = __( 'An optional webpage URL where this specific claim first appeared.', 'wpsso' );
952
953	break;
954
955	/*
956	* Schema Software Application.
957	*/
958	case 'tooltip-meta-schema_review_item_software_app_cat': // Reviews Software App Category.
959
960	$text = $this->p->msgs->get( 'tooltip-meta-schema_software_app_cat' );
961
962	break;
963
964	case 'tooltip-meta-schema_review_item_software_app_dl_url': // Reviews Software App Download URL.
965
966	$text = $this->p->msgs->get( 'tooltip-meta-schema_software_app_dl_url' );
967
968	break;
969
970	case 'tooltip-meta-schema_review_item_software_app_os': // Reviews Software App Operating System.
971
972	$text = $this->p->msgs->get( 'tooltip-meta-schema_software_app_os' );
973
974	break;
975
976	} // End of 'tooltip-meta-schema_review' switch.
977
978	break; // End of 'tooltip-meta-schema_review' case.
979
980	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_service_' ) ? true : false ):
981
982	switch ( $msg_key ) {
983
984	case 'tooltip-meta-schema_service_prov_org_id': // Provider Organization.
985	case 'tooltip-meta-schema_service_prov_person_id': // Provider Person.
986
987	$text = __( 'A service provider, service operator, or service performer.', 'wpsso' );
988
989	break;
990
991	case 'tooltip-meta-schema_service_award': // Service Awards.
992
993	$text = __( 'Awards this service has won.', 'wpsso' );
994
995	break;
996
997	case 'tooltip-meta-schema_service_offers': // Service Offers.
998
999	$text = __( 'One or more offers for the service, including the offer name, price and currency.', 'wpsso' );
1000
1001	break;
1002
1003	case 'tooltip-meta-schema_service_offers_start': // Service Offers Start.
1004
1005	$text = __( 'The date and time when tickets go on sale.', 'wpsso' );
1006
1007	break;
1008
1009	case 'tooltip-meta-schema_service_offers_end': // Service Offers End.
1010
1011	$text = __( 'The date and time when tickets are no longer on sale.', 'wpsso' );
1012
1013	break;
1014
1015	case 'tooltip-meta-schema_service_offer_catalogs': // Offer Catalogs.
1016
1017	$text = __( 'A list of offer catalogs for this service, including the catalog name, description and URL.', 'wpsso' );
1018
1019	break;
1020
1021	case 'tooltip-meta-schema_service_latitude': // Service Latitude.
1022
1023	$text = __( 'The numeric decimal degrees latitude for this service.', 'wpsso' ) . ' ';
1024
1025	$text .= __( 'You may use a service like <a href="http://www.gps-coordinates.net/">Google Maps GPS Coordinates</a> (as an example), to find the approximate GPS coordinates of a street address.', 'wpsso' );
1026
1027	break;
1028
1029	case 'tooltip-meta-schema_service_longitude': // Service Longitude.
1030
1031	$text = __( 'The numeric decimal degrees longitude for this service.', 'wpsso' ) . ' ';
1032
1033	$text .= __( 'You may use a service like <a href="http://www.gps-coordinates.net/">Google Maps GPS Coordinates</a> (as an example), to find the approximate GPS coordinates of a street address.', 'wpsso' );
1034
1035	break;
1036
1037	case 'tooltip-meta-schema_service_radius': // Service Radius.
1038
1039	$text = __( 'The geographic area where a service is provided, in meters around a set of latitude and longitude coordinates.', 'wpsso' );
1040
1041	break;
1042
1043	case 'tooltip-meta-schema_service_area_id': // Service Areas.
1044
1045	$text = __( 'An administrative area where a service is provided (ie. a school district, city, state/province, or country).', 'wpsso' ) . ' ';
1046
1047	$text .= __( 'One or more places, matching the Schema AdministrativeArea type or its sub-types, can be selected as a service area.', 'wpsso' ) . ' ';
1048
1049	break;
1050
1051	} // End of 'tooltip-meta-schema_service' switch.
1052
1053	break; // End of 'tooltip-meta-schema_service' case.
1054
1055	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_software_app_' ) ? true : false ):
1056
1057	switch ( $msg_key ) {
1058
1059	case 'tooltip-meta-schema_software_app_cat': // Application Category.
1060
1061	$text = sprintf( __( 'Type of software application (example: %s, etc.).', 'wpsso' ), '"Game, Multimedia"' );
1062
1063	break;
1064
1065	case 'tooltip-meta-schema_software_app_dl_url': // Download URL.
1066
1067	$text = __( 'URL to download the binary, if the application can be downloaded', 'wpsso' );
1068
1069	break;
1070
1071	case 'tooltip-meta-schema_software_app_os': // Operating System.
1072
1073	$text = sprintf( __( 'The operating system supported (example: %s, etc.).', 'wpsso' ),
1074	'"Windows 7", "OSX 10.6", "Android 1.6"' );
1075
1076	break;
1077
1078	} // End of 'tooltip-meta-schema_software_app' switch.
1079
1080	break; // End of 'tooltip-meta-schema_software_app' case.
1081
1082	case ( 0 === strpos( $msg_key, 'tooltip-meta-schema_webpage_' ) ? true : false ):
1083
1084	switch ( $msg_key ) {
1085
1086	case 'tooltip-meta-schema_webpage_reviewed_by_org_id': // Reviewed By Organization.
1087
1088	$text = __( 'Organizations that have reviewed the content on this web page for accuracy and/or completeness.', 'wpsso' );
1089
1090	break;
1091
1092	case 'tooltip-meta-schema_webpage_reviewed_by_person_id': // Reviewed By Person.
1093
1094	$text = __( 'Persons that have reviewed the content on this web page for accuracy and/or completeness.', 'wpsso' );
1095
1096	break;
1097
1098	case 'tooltip-meta-schema_webpage_reviewed_last': // Reviewed Last.
1099
1100	$text = __( 'Date on which the content on this web page was last reviewed for accuracy and/or completeness.', 'wpsso' );
1101
1102	break;
1103
1104	} // End of 'tooltip-meta-schema_webpage' switch.
1105
1106	break; // End of 'tooltip-meta-schema_webpage' case.
1107
1108	/*
1109	* Document SSO > Edit Media tab.
1110	*/
1111	case 'tooltip-meta-schema_img_id': // Image ID.
1112
1113	$text = __( 'A customized image ID to include first in the Schema meta tags and JSON-LD markup.', 'wpsso' ) . ' ';
1114
1115	$text .= '<em>' . __( 'This option is disabled if a custom image URL is entered.', 'wpsso' ) . '</em>';
1116
1117	break;
1118
1119	case 'tooltip-meta-schema_img_url': // or an Image URL.
1120
1121	$text = __( 'A customized image URL (instead of an image ID) to include first in the Schema meta tags and JSON-LD markup.', 'wpsso' ) . ' ';
1122
1123	$text .= '<em>' . __( 'This option is disabled if a custom image ID is selected.', 'wpsso' ) . '</em>';
1124
1125	break;
1126
1127	default:
1128
1129	$text = apply_filters( 'wpsso_messages_tooltip_meta_schema', $text, $msg_key, $info );
1130
1131	break;
1132	}
1133
1134	return $text;
1135	}
1136	}
1137	}
1138