← All changes | modules/custom-post-types/testimonial.php +409 -0 16.2-beta → 16.3 View file →

		@@ -1,0 +1,409 @@
	1	+<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
	2	+/**
	3	+ * Register a Testimonial post type and handle displaying it anywhere on the site.
	4	+ *
	5	+ * @package automattic/jetpack
	6	+ *
	7	+ * @phpcs:disable Generic.Files.OneObjectStructurePerFile.MultipleFound
	8	+ */
	9	+
	10	+// phpcs:disable Universal.Files.SeparateFunctionsFromOO.Mixed -- TODO: Move classes to appropriately-named class files.
	11	+
	12	+if ( ! class_exists( 'Jetpack_Testimonial' ) ) {
	13	+ /**
	14	+ * Add a Testimonial CPT, and display it with a shortcode
	15	+ */
	16	+ class Jetpack_Testimonial {
	17	+
	18	+ /**
	19	+ * Store an instance of the new class
	20	+ *
	21	+ * @var Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial
	22	+ */
	23	+ protected $new_instance;
	24	+
	25	+ /**
	26	+ * Initialize class.
	27	+ *
	28	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	29	+ */
	30	+ public static function init() {
	31	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	32	+ return Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial::init();
	33	+ }
	34	+
	35	+ /**
	36	+ * Conditionally hook into WordPress.
	37	+ *
	38	+ * Setup user option for enabling CPT.
	39	+ * If user has CPT enabled, show in admin.
	40	+ */
	41	+ public function __construct() {
	42	+ $this->new_instance = new Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial();
	43	+ }
	44	+
	45	+ /**
	46	+ * Forward all method calls to the Jetpack_Testimonial class.
	47	+ *
	48	+ * @param string $name The name of the method.
	49	+ * @param array $arguments The arguments to pass to the method.
	50	+ *
	51	+ * @throws Exception If the method is not found.
	52	+ */
	53	+ public function __call( $name, $arguments ) {
	54	+ if ( method_exists( $this->new_instance, $name ) ) {
	55	+ return call_user_func_array( array( $this->new_instance, $name ), $arguments );
	56	+ } else {
	57	+ // Handle cases where the method is not found
	58	+ throw new Exception( sprintf( 'Undefined method: %s', esc_html( $name ) ) );
	59	+ }
	60	+ }
	61	+
	62	+ /**
	63	+ * Forward all static method calls to the Jetpack_Testimonial class.
	64	+ *
	65	+ * @param string $name The name of the method.
	66	+ * @param array $arguments The arguments to pass to the method.
	67	+ *
	68	+ * @throws Exception If the method is not found.
	69	+ */
	70	+ public static function __callStatic( $name, $arguments ) {
	71	+ if ( method_exists( Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial::class, $name ) ) {
	72	+ return call_user_func_array( array( Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial::class, $name ), $arguments );
	73	+ } else {
	74	+ // Handle cases where the method is not found
	75	+ throw new Exception( sprintf( 'Undefined static method: %s', esc_html( $name ) ) );
	76	+ }
	77	+ }
	78	+
	79	+ /**
	80	+ * Registers the custom post types and adds action/filter handlers, but
	81	+ * only if the site supports it.
	82	+ *
	83	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	84	+ */
	85	+ public function maybe_register_cpt() {
	86	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	87	+ $this->new_instance->maybe_register_cpt();
	88	+ }
	89	+
	90	+ /**
	91	+ * Add a checkbox field in 'Settings' > 'Writing'
	92	+ * for enabling CPT functionality.
	93	+ *
	94	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	95	+ *
	96	+ * @return void
	97	+ */
	98	+ public function settings_api_init() {
	99	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	100	+ $this->new_instance->settings_api_init();
	101	+ }
	102	+
	103	+ /**
	104	+ * HTML code to display a checkbox true/false option
	105	+ * for the CPT setting.
	106	+ *
	107	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	108	+ *
	109	+ * @return void
	110	+ */
	111	+ public function setting_html() {
	112	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	113	+ $this->new_instance->setting_html();
	114	+ }
	115	+
	116	+ /**
	117	+ * Add to REST API post type allowed list.
	118	+ *
	119	+ * @param array $post_types Array of allowed post types.
	120	+ * @return array `$post_types` with our type added.
	121	+ */
	122	+ public function allow_cpt_rest_api_type( $post_types ) {
	123	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	124	+ return $this->new_instance->allow_cpt_rest_api_type( $post_types );
	125	+ }
	126	+
	127	+ /**
	128	+ * Bump Testimonial > New Activation stat
	129	+ *
	130	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	131	+ */
	132	+ public function new_activation_stat_bump() {
	133	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	134	+ $this->new_instance->new_activation_stat_bump();
	135	+ }
	136	+
	137	+ /**
	138	+ * Bump Testimonial > Option On/Off stats to get total active
	139	+ *
	140	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	141	+ *
	142	+ * @param mixed $old The old option value.
	143	+ * @param mixed $new The new option value.
	144	+ */
	145	+ public function update_option_stat_bump( $old, $new ) {
	146	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	147	+ $this->new_instance->update_option_stat_bump( $old, $new );
	148	+ }
	149	+
	150	+ /**
	151	+ * Bump Testimonial > Published Testimonials stat when testimonials are published
	152	+ *
	153	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	154	+ */
	155	+ public function new_testimonial_stat_bump() {
	156	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	157	+ $this->new_instance->new_testimonial_stat_bump();
	158	+ }
	159	+
	160	+ /**
	161	+ * Flush permalinks when CPT option is turned on/off
	162	+ *
	163	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	164	+ */
	165	+ public function flush_rules_on_enable() {
	166	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	167	+ $this->new_instance->flush_rules_on_enable();
	168	+ }
	169	+
	170	+ /**
	171	+ * Count published testimonials and flush permalinks when first testimonial is published
	172	+ *
	173	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	174	+ */
	175	+ public function flush_rules_on_first_testimonial() {
	176	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	177	+ $this->new_instance->flush_rules_on_first_testimonial();
	178	+ }
	179	+
	180	+ /**
	181	+ * Flush permalinks when CPT supported theme is activated
	182	+ *
	183	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	184	+ */
	185	+ public function flush_rules_on_switch() {
	186	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	187	+ $this->new_instance->flush_rules_on_switch();
	188	+ }
	189	+
	190	+ /**
	191	+ * On plugin/theme activation, check if current theme supports CPT
	192	+ *
	193	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	194	+ */
	195	+ public static function activation_post_type_support() {
	196	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	197	+ Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial::activation_post_type_support();
	198	+ }
	199	+
	200	+ /**
	201	+ * On theme switch, check if CPT item exists and disable if not
	202	+ *
	203	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	204	+ */
	205	+ public function deactivation_post_type_support() {
	206	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	207	+ $this->new_instance->deactivation_post_type_support();
	208	+ }
	209	+
	210	+ /**
	211	+ * Register Post Type
	212	+ *
	213	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	214	+ */
	215	+ public function register_post_types() {
	216	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	217	+ $this->new_instance->register_post_types();
	218	+ }
	219	+
	220	+ /**
	221	+ * Update messages for the Testimonial admin.
	222	+ *
	223	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	224	+ *
	225	+ * @param array $messages Existing post update messages.
	226	+ * @return array Updated `$messages`.
	227	+ */
	228	+ public function updated_messages( $messages ) {
	229	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	230	+ return $this->new_instance->updated_messages( $messages );
	231	+ }
	232	+
	233	+ /**
	234	+ * Change ‘Enter Title Here’ text for the Testimonial.
	235	+ *
	236	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	237	+ *
	238	+ * @param string $title Placeholder text. Default 'Add title'.
	239	+ * @return string Replacement title.
	240	+ */
	241	+ public function change_default_title( $title ) {
	242	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	243	+ return $this->new_instance->change_default_title( $title );
	244	+ }
	245	+
	246	+ /**
	247	+ * Change ‘Title’ column label on all Testimonials page.
	248	+ *
	249	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	250	+ *
	251	+ * @param array $columns An array of column names.
	252	+ * @return array Updated array.
	253	+ */
	254	+ public function edit_title_column_label( $columns ) {
	255	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	256	+ return $this->new_instance->edit_title_column_label( $columns );
	257	+ }
	258	+
	259	+ /**
	260	+ * Follow CPT reading setting on CPT archive page
	261	+ *
	262	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	263	+ *
	264	+ * @param WP_Query $query A WP_Query instance.
	265	+ */
	266	+ public function query_reading_setting( $query ) {
	267	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	268	+ $this->new_instance->query_reading_setting( $query );
	269	+ }
	270	+
	271	+ /**
	272	+ * If Infinite Scroll is set to 'click', use our custom reading setting instead of core's `posts_per_page`.
	273	+ *
	274	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	275	+ *
	276	+ * @param array $settings Array of Infinite Scroll settings.
	277	+ * @return array Updated `$settings`.
	278	+ */
	279	+ public function infinite_scroll_click_posts_per_page( $settings ) {
	280	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	281	+ return $this->new_instance->infinite_scroll_click_posts_per_page( $settings );
	282	+ }
	283	+
	284	+ /**
	285	+ * Add CPT to Dotcom sitemap
	286	+ *
	287	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	288	+ *
	289	+ * @param array $post_types Array of post types included in sitemap.
	290	+ * @return array Updated `$post_types`.
	291	+ */
	292	+ public function add_to_sitemap( $post_types ) {
	293	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	294	+ return $this->new_instance->add_to_sitemap( $post_types );
	295	+ }
	296	+
	297	+ /**
	298	+ * Adds a submenu link to the Customizer.
	299	+ *
	300	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	301	+ */
	302	+ public function add_customize_page() {
	303	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	304	+ $this->new_instance->add_customize_page();
	305	+ }
	306	+
	307	+ /**
	308	+ * Adds testimonial section to the Customizer.
	309	+ *
	310	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	311	+ *
	312	+ * @param WP_Customize_Manager $wp_customize Customizer instance.
	313	+ */
	314	+ public function customize_register( $wp_customize ) {
	315	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	316	+ $this->new_instance->customize_register( $wp_customize );
	317	+ }
	318	+
	319	+ /**
	320	+ * Add Featured image to theme mod if necessary.
	321	+ *
	322	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	323	+ *
	324	+ * @param array $opt The value of the current theme modification.
	325	+ * @return array Updated `$opt`.
	326	+ */
	327	+ public function coerce_testimonial_image_to_url( $opt ) {
	328	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	329	+ return $this->new_instance->coerce_testimonial_image_to_url( $opt );
	330	+ }
	331	+
	332	+ /**
	333	+ * Our [testimonial] shortcode.
	334	+ * Prints Testimonial data styled to look good on *any* theme.
	335	+ *
	336	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	337	+ *
	338	+ * @param array $atts Shortcode attributes.
	339	+ *
	340	+ * @return string HTML from `self::jetpack_testimonial_shortcode_html()`.
	341	+ */
	342	+ public static function jetpack_testimonial_shortcode( $atts ) {
	343	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	344	+ return Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial::jetpack_testimonial_shortcode( $atts );
	345	+ }
	346	+ }
	347	+
	348	+ /**
	349	+ * Additional Testimonial customizer options.
	350	+ *
	351	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	352	+ */
	353	+ function jetpack_testimonial_custom_control_classes() {
	354	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	355	+ /**
	356	+ * Clean the title parameter.
	357	+ */
	358	+ class Jetpack_Testimonial_Title_Control extends WP_Customize_Control {
	359	+ /**
	360	+ * Sanitize content passed to control.
	361	+ *
	362	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	363	+ *
	364	+ * @param string $value Control value.
	365	+ * @return string Sanitized value.
	366	+ */
	367	+ public static function sanitize_content( $value ) {
	368	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	369	+ return Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial_Title_Control::sanitize_content( $value );
	370	+ }
	371	+ }
	372	+
	373	+ /**
	374	+ * Clean textarea content.
	375	+ */
	376	+ class Jetpack_Testimonial_Textarea_Control extends WP_Customize_Control {
	377	+ /**
	378	+ * Control type.
	379	+ *
	380	+ * @var string
	381	+ */
	382	+ public $type = 'textarea';
	383	+
	384	+ /**
	385	+ * Render the control's content.
	386	+ *
	387	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	388	+ */
	389	+ public function render_content() {
	390	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	391	+ $testimonial_textarea_control = new Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial_Textarea_Control( $this->manager, $this->id, $this->args );
	392	+ $testimonial_textarea_control->render_content();
	393	+ }
	394	+
	395	+ /**
	396	+ * Sanitize content passed to control.
	397	+ *
	398	+ * @deprecated 14.2 Moved to Classic Theme Helper package.
	399	+ *
	400	+ * @param string $value Control value.
	401	+ * @return string Sanitized value.
	402	+ */
	403	+ public static function sanitize_content( $value ) {
	404	+ _deprecated_function( __FUNCTION__, 'jetpack-14.2' );
	405	+ return Automattic\Jetpack\Classic_Theme_Helper\Jetpack_Testimonial_Textarea_Control::sanitize_content( $value );
	406	+ }
	407	+ }
	408	+ }
	409	+}