social-links.php — Jetpack – WP Security, Backup, Speed, & Growth 15.0.3

jetpack / modules / theme-tools / social-links.php

jetpack / modules / theme-tools Last commit date

compat 1 year ago content-options 11 months ago js 6 years ago responsive-videos 1 year ago site-logo 1 year ago social-menu 11 months ago content-options.php 1 year ago featured-content.php 1 year ago responsive-videos.php 1 year ago site-breadcrumbs.php 2 years ago site-logo.php 1 year ago social-links.php 11 months ago social-menu.php 1 year ago

social-links.php

133 lines

1	<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
2	/**
3	* Theme Tools: Social Links.
4	*
5	* This feature will only be activated for themes that declare their support.
6	* This can be done by adding code similar to the following during the
7	* 'after_setup_theme' action:
8	*
9	* add_theme_support( 'social-links', array(
10	* 'facebook', 'twitter', 'linkedin', 'tumblr',
11	* ) );
12	*
13	* @package automattic/jetpack
14	*/
15
16	use Automattic\Jetpack\Status\Host;
17
18	// phpcs:disable Universal.Files.SeparateFunctionsFromOO.Mixed -- TODO: Move classes to appropriately-named class files.
19
20	if ( ! function_exists( 'jetpack_theme_supports_social_links' ) ) {
21	/**
22	* Init Social_Links if the theme declares support.
23	*/
24	function jetpack_theme_supports_social_links() {
25	new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links();
26	}
27	if ( ! ( new Host() )->is_wpcom_platform() ) {
28	add_action( 'init', 'jetpack_theme_supports_social_links', 30 );
29	}
30	}
31
32	if ( ! class_exists( 'Social_Links' ) ) {
33
34	/**
35	* Social_Links main class.
36	*
37	* @deprecated 13.8 Moved to Classic Theme Helper package.
38	*/
39	class Social_Links {
40
41	/**
42	* Constructor.
43	*
44	* @deprecated 13.8 Moved to Classic Theme Helper package.
45	*/
46	public function __construct() {
47	_deprecated_function( __METHOD__, '13.8', 'Automattic\\Jetpack\\Classic_Theme_Helper\\Social_Links->__construct' );
48	new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links();
49	}
50
51	/**
52	* Init the admin setup.
53	*
54	* @deprecated 13.8 Moved to Classic Theme Helper package.
55	*/
56	public function admin_setup() {
57	_deprecated_function( __METHOD__, '13.8', 'Automattic\\Jetpack\\Classic_Theme_Helper\\Social_Links->admin_setup' );
58	$social_links_instance = new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links();
59	$social_links_instance->admin_setup();
60	}
61
62	/**
63	* Compares the currently saved links with the connected services and removes
64	* links from services that are no longer connected.
65	*
66	* @deprecated 13.8 Moved to Classic Theme Helper package.
67	* @return void
68	*/
69	public function check_links() {
70	_deprecated_function( __METHOD__, '13.8', 'Automattic\\Jetpack\\Classic_Theme_Helper\\Social_Links->check_links' );
71	$social_links_instance = new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links();
72	$social_links_instance->check_links();
73	}
74
75	/**
76	* Add social link dropdown to the Customizer.
77	*
78	* @deprecated 13.8 Moved to Classic Theme Helper package.
79	* @param WP_Customize_Manager $wp_customize Theme Customizer object.
80	*/
81	public function customize_register( $wp_customize ) {
82	_deprecated_function( __METHOD__, '13.8', 'Automattic\\Jetpack\\Classic_Theme_Helper\\Social_Links->customize_register' );
83	$social_links_instance = new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links();
84	$social_links_instance->customize_register( $wp_customize );
85	}
86
87	/**
88	* Sanitizes social links.
89	*
90	* @deprecated 13.8 Moved to Classic Theme Helper package.
91	* @param array $option The incoming values to be sanitized.
92	* @return array
93	*/
94	public function sanitize_link( $option ) {
95	_deprecated_function( __METHOD__, '13.8', 'Automattic\\Jetpack\\Classic_Theme_Helper\\Social_Links->sanitize_link' );
96	return ( new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links() )->sanitize_link( $option );
97	}
98
99	/**
100	* Returns whether there are any social links set.
101	*
102	* @deprecated 13.8 Moved to Classic Theme Helper package.
103	* @return bool
104	*/
105	public function has_social_links() {
106	_deprecated_function( __METHOD__, '13.8', 'Automattic\\Jetpack\\Classic_Theme_Helper\\Social_Links->has_social_links' );
107	return ( new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links() )->has_social_links(); }
108
109	/**
110	* Return available social links.
111	*
112	* @return array
113	*/
114	public function get_social_links() {
115	_deprecated_function( __METHOD__, '13.8', 'Automattic\\Jetpack\\Classic_Theme_Helper\\Social_Links->get_social_links' );
116	return ( new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links() )->get_social_links();
117	}
118
119	/**
120	* Short-circuits get_option and get_theme_mod calls.
121	*
122	* @deprecated 13.8 Moved to Classic Theme Helper package.
123	* @param string $link The incoming value to be replaced.
124	* @return string $link The social link that we've got.
125	*/
126	public function get_social_link_filter( $link ) {
127	_deprecated_function( __METHOD__, '13.8', 'Automattic\\Jetpack\\Classic_Theme_Helper\\Social_Links->get_social_link_filter' );
128	return ( new \Automattic\Jetpack\Classic_Theme_Helper\Social_Links() )->get_social_link_filter( $link );
129	}
130	}
131
132	} // - end if ( ! class_exists( 'Social_Links' )
133