Jetpack_Related_Posts_Customize - Code Metrics - Inspection of "New build" - Automattic/jetpack - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — branch-4.5-built ( c976d8...6f3e53 )

unknown

created 2017-01-03 19:43 UTC

Jetpack_Related_Posts_Customize A

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	229
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Importance

Changes

Metric	Value
dl	0
loc	229
rs	10
c	0
b	0
f	0
wmc	25
lcom	1
cbo	2

7 Methods

Rating	Name	Size	Complexity
A	render_callback()	3	1
A	is_single()	3	1
A	is_not_single()	3	1
A	__construct()	4	1
C	customize_register()	62	16
B	get_options()	84	4
A	customize_controls_enqueue_scripts()	3	1

<?php

// Exit if file is accessed directly
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class to include elements to modify Related Posts look in Customizer.
 *
 * @since 4.4.0
 */
class Jetpack_Related_Posts_Customize {

	/**
	 * Key for panel, section and prefix for options. Same option name than in Options > Reading.
	 *
	 * @var string
	 */
	var $prefix = 'jetpack_relatedposts';
class A {
    var $property;
}

	/**
	 * @var string Control to focus when customizer loads.
	 */
	var $focus = '';
class A {
    var $property;
}

	/**
	 * Class initialization.
	 *
	 * @since 4.4.0
	 */
	function __construct() {
		add_action( 'customize_register', array( $this, 'customize_register' ) );
		add_action( 'customize_controls_enqueue_scripts', array( $this, 'customize_controls_enqueue_scripts' ) );
	}

	/**
	 * Initialize Customizer controls.
	 *
	 * @since 4.4.0
	 *
	 * @param WP_Customize_Manager $wp_customize Customizer instance.
	 */
	function customize_register( $wp_customize ) {

		$wp_customize->add_section( $this->prefix,
			array(
				'title' 	  => esc_html__( 'Related Posts', 'jetpack' ),
				'description' => '',
				'capability'  => 'edit_theme_options',
				'priority' 	  => 200,
			)
		);

		$selective_options = array();

		foreach ( $this->get_options( $wp_customize ) as $key => $field ) {
			$control_id = "$this->prefix[$key]";
			$selective_options[] = $control_id;
			$wp_customize->add_setting( $control_id,
				array(
					'default' 	 => isset( $field['default'] ) ? $field['default'] : '',
					'type' 		 => isset( $field['setting_type'] ) ? $field['setting_type'] : 'option',
					'capability' => isset( $field['capability'] ) ? $field['capability'] : 'edit_theme_options',
					'transport'  => isset( $field['transport'] ) ? $field['transport'] : 'postMessage',
				)
			);
			$control_settings = array(
				'label' 	  => isset( $field['label'] ) ? $field['label'] : '',
				'description' => isset( $field['description'] ) ? $field['description'] : '',
				'settings' 	  => $control_id,
				'type' 	      => isset( $field['control_type'] ) ? $field['control_type'] : 'text',
				'section' 	  => $this->prefix,
				'priority' 	  => 10,
				'active_callback' => isset( $field['active_callback'] ) ? $field['active_callback'] : __CLASS__ . '::is_single',
			);
			switch ( $field['control_type'] ) {
				case 'text':
				case 'checkbox':
				default:
					$wp_customize->add_control( new WP_Customize_Control( $wp_customize, $control_id, $control_settings ) );
					break;
				case 'select':
function fx() {
    try {
        doSomething();
        return true;
    }
    catch (\Exception $e) {
        return false;
    }

    return false;
}
					if ( isset( $field['choices'] ) ) {
						$control_settings['choices'] = $field['choices'];
						$wp_customize->add_control( new WP_Customize_Control( $wp_customize, $control_id, $control_settings ) );
					}
					break;
				case 'message':
					$wp_customize->add_control( new Jetpack_Message_Control( $wp_customize, $control_id, $control_settings ) );
					break;
			}
		}

		// If selective refresh is available, implement it.
		if ( isset( $wp_customize->selective_refresh ) ) {
			$wp_customize->selective_refresh->add_partial( "$this->prefix", array(
				'selector'            => '.jp-relatedposts',
				'settings'            => $selective_options,
				'render_callback'     => __CLASS__ . '::render_callback',
				'container_inclusive' => false,
			) );
		}

	}

	/**
	 * Callback that outputs the headline based on user choice.
	 *
	 * @since 4.4.0
	 */
	public static function render_callback() {
		echo Jetpack_RelatedPosts::init()->get_headline();
	}

	/**
	 * Check that we're in a single post view.
	 *
	 * @since 4.4.0
	 *
	 * @return bool
	 */
	public static function is_single() {
		return is_single();
	}

	/**
	 * Check that we're not in a single post view.
	 *
	 * @since 4.4.0
	 *
	 * @return bool
	 */
	public static function is_not_single() {
		return ! is_single();
	}

	/**
	 * Return list of options to modify.
	 *
	 * @since 4.4.0
	 *
	 * @param object $wp_customize Instance of WP Customizer
	 *
	 * @return mixed|void
	 */
	function get_options( $wp_customize ) {
		$transport = isset( $wp_customize->selective_refresh ) ? 'postMessage' : 'refresh';

		// Get the correct translated string for preview in WP 4.7 and later.
		$switched_locale = function_exists( 'switch_to_locale' )
			? switch_to_locale( get_user_locale() )
			: false;
		$headline = __( 'Related', 'jetpack' );
		if ( $switched_locale ) {
			restore_previous_locale();
		}

		return apply_filters(
			'jetpack_related_posts_customize_options', array(
				'enabled'       => array(
					'control_type' => 'hidden',
					'default'      => 1,
					'setting_type' => 'option',
					'transport'    => $transport,
				),
				'show_headline'       => array(
					'label'        => esc_html__( 'Show a headline', 'jetpack' ),
					'description'  => esc_html__( 'This helps to clearly separate the related posts from post content.', 'jetpack' ),
					'control_type' => 'checkbox',
					'default'      => 1,
					'setting_type' => 'option',
					'transport'    => $transport,
				),
				'headline'       => array(
					'label'        => '',
					'description'  => esc_html__( 'Enter text to use as headline.', 'jetpack' ),
					'control_type' => 'text',
					'default'      => esc_html( $headline ),
					'setting_type' => 'option',
					'transport'    => $transport,
				),
				'show_thumbnails'     => array(
					'label'        => esc_html__( 'Show thumbnails', 'jetpack' ),
					'description'  => esc_html__( 'Use a large and visually striking layout.', 'jetpack' ),
					'control_type' => 'checkbox',
					'default'      => 1,
					'setting_type' => 'option',
					'transport'    => $transport,
				),
				'show_date'           => array(
					'label'        => esc_html__( 'Show date', 'jetpack' ),
					'description'  => esc_html__( 'Display date when entry was published.', 'jetpack' ),
					'control_type' => 'checkbox',
					'default'      => 1,
					'setting_type' => 'option',
					'transport'    => $transport,
				),
				'show_context'        => array(
					'label'        => esc_html__( 'Show context', 'jetpack' ),
					'description'  => esc_html__( "Display entry's category or tag.", 'jetpack' ),
					'control_type' => 'checkbox',
					'default'      => 1,
					'setting_type' => 'option',
					'transport'    => $transport,
				),
				'layout'        => array(
					'label'        => esc_html__( 'Layout', 'jetpack' ),
					'description'  => esc_html__( 'Arrange entries in different layouts.', 'jetpack' ),
					'control_type' => 'select',
					'choices'	   => array(
						'grid' => esc_html__( 'Grid', 'jetpack' ),
						'list' => esc_html__( 'List', 'jetpack' ),
					),
					'default'      => 'grid',
					'setting_type' => 'option',
					'transport'    => $transport,
				),
				'msg_go_to_single' => array(
					'description'     => esc_html__( 'Please visit a single post view to reveal the customization options.', 'jetpack' ),
					'control_type'    => 'message',
					'active_callback' => __CLASS__ . '::is_not_single',
				),
				'msg_example'      => array(
					'description'  => esc_html__( 'Please note that the related posts displayed now are only for previewing purposes.', 'jetpack' ),
					'control_type' => 'message',
				),
			)
		);
	}

	/**
	 * Enqueue assets for Customizer controls.
	 *
	 * @since 4.4.0
	 */
	function customize_controls_enqueue_scripts() {
		wp_enqueue_script( 'jetpack_related-posts-customizer', plugins_url( 'related-posts-customizer.js', __FILE__ ), array( 'customize-controls' ), JETPACK__VERSION);
	}

} // class end

/**
 * Control that displays a message in Customizer.
 *
 * @since 4.4.0
 */
class Jetpack_Message_Control extends WP_Customize_Control {


	/**
	 * Render the message.
	 *
	 * @since 4.4.0
	 */
	public function render_content() {
		echo '<p class="description">' . esc_html( $this->description ) . '</p>';
	}
} // class end

// Initialize controls
new Jetpack_Related_Posts_Customize;

1			<?php
2
3			// Exit if file is accessed directly
4			if ( ! defined( 'ABSPATH' ) ) {
5			exit;
6			}
7
8			/**
9			* Class to include elements to modify Related Posts look in Customizer.
10			*
11			* @since 4.4.0
12			*/
13			class Jetpack_Related_Posts_Customize {
14
15			/**
16			* Key for panel, section and prefix for options. Same option name than in Options > Reading.
17			*
18			* @var string
19			*/
20			var $prefix = 'jetpack_relatedposts';
			0 ignored issues – show Coding Style introduced 2016-07-04 16:58 UTC by Report Bug Copy Issue Report The visibility should be declared for property `$prefix`. The PSR-2 coding standard requires that all properties in a class have their visibility explicitly declared. If you declare a property using class A { var $property; } the property is implicitly global. To learn more about the PSR-2, please see the PHP-FIG site on the PSR-2. Loading history...
21
22			/**
23			* @var string Control to focus when customizer loads.
24			*/
25			var $focus = '';
			0 ignored issues – show Coding Style introduced 2016-07-04 16:58 UTC by Report Bug Copy Issue Report The visibility should be declared for property `$focus`. The PSR-2 coding standard requires that all properties in a class have their visibility explicitly declared. If you declare a property using class A { var $property; } the property is implicitly global. To learn more about the PSR-2, please see the PHP-FIG site on the PSR-2. Loading history...
26
27			/**
28			* Class initialization.
29			*
30			* @since 4.4.0
31			*/
32			function __construct() {
33			add_action( 'customize_register', array( $this, 'customize_register' ) );
34			add_action( 'customize_controls_enqueue_scripts', array( $this, 'customize_controls_enqueue_scripts' ) );
35			}
36
37			/**
38			* Initialize Customizer controls.
39			*
40			* @since 4.4.0
41			*
42			* @param WP_Customize_Manager $wp_customize Customizer instance.
43			*/
44			function customize_register( $wp_customize ) {
45
46			$wp_customize->add_section( $this->prefix,
47			array(
48			'title' => esc_html__( 'Related Posts', 'jetpack' ),
49			'description' => '',
50			'capability' => 'edit_theme_options',
51			'priority' => 200,
52			)
53			);
54
55			$selective_options = array();
56
57			foreach ( $this->get_options( $wp_customize ) as $key => $field ) {
58			$control_id = "$this->prefix[$key]";
59			$selective_options[] = $control_id;
60			$wp_customize->add_setting( $control_id,
61			array(
62			'default' => isset( $field['default'] ) ? $field['default'] : '',
63			'type' => isset( $field['setting_type'] ) ? $field['setting_type'] : 'option',
64			'capability' => isset( $field['capability'] ) ? $field['capability'] : 'edit_theme_options',
65			'transport' => isset( $field['transport'] ) ? $field['transport'] : 'postMessage',
66			)
67			);
68			$control_settings = array(
69			'label' => isset( $field['label'] ) ? $field['label'] : '',
70			'description' => isset( $field['description'] ) ? $field['description'] : '',
71			'settings' => $control_id,
72			'type' => isset( $field['control_type'] ) ? $field['control_type'] : 'text',
73			'section' => $this->prefix,
74			'priority' => 10,
75			'active_callback' => isset( $field['active_callback'] ) ? $field['active_callback'] : __CLASS__ . '::is_single',
76			);
77			switch ( $field['control_type'] ) {
78			case 'text':
79			case 'checkbox':
80			default:
81			$wp_customize->add_control( new WP_Customize_Control( $wp_customize, $control_id, $control_settings ) );
82			break;
83			case 'select':
			0 ignored issues – show Unused Code introduced 2016-09-20 23:32 UTC by Report Bug Copy Issue Report `case 'select': if (i...ngs)); } break;` does not seem to be reachable. This check looks for unreachable code. It uses sophisticated control flow analysis techniques to find statements which will never be executed. Unreachable code is most often the result of `return`, `die` or `exit` statements that have been added for debug purposes. function fx() { try { doSomething(); return true; } catch (\Exception $e) { return false; } return false; } In the above example, the last `return false` will never be executed, because a return statement has already been met in every possible execution path. Loading history...
84			if ( isset( $field['choices'] ) ) {
85			$control_settings['choices'] = $field['choices'];
86			$wp_customize->add_control( new WP_Customize_Control( $wp_customize, $control_id, $control_settings ) );
87			}
88			break;
89			case 'message':
90			$wp_customize->add_control( new Jetpack_Message_Control( $wp_customize, $control_id, $control_settings ) );
91			break;
92			}
93			}
94
95			// If selective refresh is available, implement it.
96			if ( isset( $wp_customize->selective_refresh ) ) {
97			$wp_customize->selective_refresh->add_partial( "$this->prefix", array(
98			'selector' => '.jp-relatedposts',
99			'settings' => $selective_options,
100			'render_callback' => __CLASS__ . '::render_callback',
101			'container_inclusive' => false,
102			) );
103			}
104
105			}
106
107			/**
108			* Callback that outputs the headline based on user choice.
109			*
110			* @since 4.4.0
111			*/
112			public static function render_callback() {
113			echo Jetpack_RelatedPosts::init()->get_headline();
114			}
115
116			/**
117			* Check that we're in a single post view.
118			*
119			* @since 4.4.0
120			*
121			* @return bool
122			*/
123			public static function is_single() {
124			return is_single();
125			}
126
127			/**
128			* Check that we're not in a single post view.
129			*
130			* @since 4.4.0
131			*
132			* @return bool
133			*/
134			public static function is_not_single() {
135			return ! is_single();
136			}
137
138			/**
139			* Return list of options to modify.
140			*
141			* @since 4.4.0
142			*
143			* @param object $wp_customize Instance of WP Customizer
144			*
145			* @return mixed\|void
146			*/
147			function get_options( $wp_customize ) {
148			$transport = isset( $wp_customize->selective_refresh ) ? 'postMessage' : 'refresh';
149
150			// Get the correct translated string for preview in WP 4.7 and later.
151			$switched_locale = function_exists( 'switch_to_locale' )
152			? switch_to_locale( get_user_locale() )
153			: false;
154			$headline = __( 'Related', 'jetpack' );
155			if ( $switched_locale ) {
156			restore_previous_locale();
157			}
158
159			return apply_filters(
160			'jetpack_related_posts_customize_options', array(
161			'enabled' => array(
162			'control_type' => 'hidden',
163			'default' => 1,
164			'setting_type' => 'option',
165			'transport' => $transport,
166			),
167			'show_headline' => array(
168			'label' => esc_html__( 'Show a headline', 'jetpack' ),
169			'description' => esc_html__( 'This helps to clearly separate the related posts from post content.', 'jetpack' ),
170			'control_type' => 'checkbox',
171			'default' => 1,
172			'setting_type' => 'option',
173			'transport' => $transport,
174			),
175			'headline' => array(
176			'label' => '',
177			'description' => esc_html__( 'Enter text to use as headline.', 'jetpack' ),
178			'control_type' => 'text',
179			'default' => esc_html( $headline ),
180			'setting_type' => 'option',
181			'transport' => $transport,
182			),
183			'show_thumbnails' => array(
184			'label' => esc_html__( 'Show thumbnails', 'jetpack' ),
185			'description' => esc_html__( 'Use a large and visually striking layout.', 'jetpack' ),
186			'control_type' => 'checkbox',
187			'default' => 1,
188			'setting_type' => 'option',
189			'transport' => $transport,
190			),
191			'show_date' => array(
192			'label' => esc_html__( 'Show date', 'jetpack' ),
193			'description' => esc_html__( 'Display date when entry was published.', 'jetpack' ),
194			'control_type' => 'checkbox',
195			'default' => 1,
196			'setting_type' => 'option',
197			'transport' => $transport,
198			),
199			'show_context' => array(
200			'label' => esc_html__( 'Show context', 'jetpack' ),
201			'description' => esc_html__( "Display entry's category or tag.", 'jetpack' ),
202			'control_type' => 'checkbox',
203			'default' => 1,
204			'setting_type' => 'option',
205			'transport' => $transport,
206			),
207			'layout' => array(
208			'label' => esc_html__( 'Layout', 'jetpack' ),
209			'description' => esc_html__( 'Arrange entries in different layouts.', 'jetpack' ),
210			'control_type' => 'select',
211			'choices' => array(
212			'grid' => esc_html__( 'Grid', 'jetpack' ),
213			'list' => esc_html__( 'List', 'jetpack' ),
214			),
215			'default' => 'grid',
216			'setting_type' => 'option',
217			'transport' => $transport,
218			),
219			'msg_go_to_single' => array(
220			'description' => esc_html__( 'Please visit a single post view to reveal the customization options.', 'jetpack' ),
221			'control_type' => 'message',
222			'active_callback' => __CLASS__ . '::is_not_single',
223			),
224			'msg_example' => array(
225			'description' => esc_html__( 'Please note that the related posts displayed now are only for previewing purposes.', 'jetpack' ),
226			'control_type' => 'message',
227			),
228			)
229			);
230			}
231
232			/**
233			* Enqueue assets for Customizer controls.
234			*
235			* @since 4.4.0
236			*/
237			function customize_controls_enqueue_scripts() {
238			wp_enqueue_script( 'jetpack_related-posts-customizer', plugins_url( 'related-posts-customizer.js', __FILE__ ), array( 'customize-controls' ), JETPACK__VERSION);
239			}
240
241			} // class end
242
243			/**
244			* Control that displays a message in Customizer.
245			*
246			* @since 4.4.0
247			*/
248			class Jetpack_Message_Control extends WP_Customize_Control {
			0 ignored issues – show Coding Style Compatibility introduced 2016-09-15 19:07 UTC by Report Bug Copy Issue Report PSR1 recommends that each class should be in its own file to aid autoloaders. Having each class in a dedicated file usually plays nice with PSR autoloaders and is therefore a well established practice. If you use other autoloaders, you might not want to follow this rule. Loading history...
249
250			/**
251			* Render the message.
252			*
253			* @since 4.4.0
254			*/
255			public function render_content() {
256			echo '<p class="description">' . esc_html( $this->description ) . '</p>';
257			}
258			} // class end
259
260			// Initialize controls
261			new Jetpack_Related_Posts_Customize;

Automattic / jetpack

Push — branch-4.5-built ( c976d8...6f3e53 )

Jetpack_Related_Posts_Customize A

Complexity

Size/Duplication

Coupling/Cohesion

Importance

7 Methods

Duplication Side-by-Side

Filter issues like