BaseModule::__construct() - Code Metrics - Inspection of "Apply fixes from StyleCI" - sudar/bulk-delete - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — analysis-8bk1ra ( 2917e1 )

by Sudar

created 2018-04-30 22:24 UTC

BaseModule::__construct() A

↳ Parent: BaseModule

Complexity

Conditions	1
Paths	1

Size

Total Lines	2
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes

Metric	Value
cc	1
eloc	1
nc	1
nop	0
dl	0
loc	2
ccs	2
cts	2
cp	1
crap	1
rs	10
c	0
b	0
f	0

<?php

namespace BulkWP\BulkDelete\Core\Base;

use BulkWP\BulkDelete\Core\Base\Mixin\Renderer;

defined( 'ABSPATH' ) || exit; // Exit if accessed directly.

/**
 * Encapsulates the Bulk Delete Meta box Module Logic.
 *
 * All Bulk Delete Meta box Modules should extend this class.
 * This class extends Renderer Mixin class since Bulk Delete still supports PHP 5.3.
 * Once PHP 5.3 support is dropped, Renderer will be implemented as a Trait and this class will `use` it.
 *
 * @since 6.0.0
 */
abstract class BaseModule extends Renderer {
	/**
	 * Item Type. Possible values 'posts', 'pages', 'users' etc.
	 *
	 * @var string
	 */
	protected $item_type;

	/**
	 * The hook suffix of the screen where this meta box would be shown.
	 *
	 * @var string
	 */
	protected $page_hook_suffix;

	/**
	 * Slug of the page where this module will be shown.
	 *
	 * @var string
	 */
	protected $page_slug;

	/**
	 * Slug for the form fields.
	 *
	 * @var string
	 */
	protected $field_slug;

	/**
	 * Slug of the meta box.
	 *
	 * @var string
	 */
	protected $meta_box_slug;

	/**
	 * Action in which the delete operation should be performed.
	 *
	 * @var string
	 */
	protected $action;

	/**
	 * Hook for scheduler.
	 *
	 * @var string
	 */
	protected $cron_hook;

	/**
	 * Url of the scheduler addon.
	 *
	 * @var string
	 */
	protected $scheduler_url;

	/**
	 * Messages shown to the user.
	 *
	 * @var array
	 */
	protected $messages = array(
		'box_label' => '',
	);

	/**
	 * Initialize and setup variables.
	 *
	 * @return void
	 */
	abstract protected function initialize();

	/**
	 * Render the Modules.
	 *
	 * @return void
	 */
	abstract public function render();

	/**
	 * Process user input and create metabox options.
	 *
	 * @param array $request Request array.
	 * @param array $options User options.
	 *
	 * @return array User options.
	 */
	abstract protected function convert_user_input_to_options( $request, $options );

	/**
	 * Perform the deletion.
	 *
	 * @param array $options Array of Delete options.
	 *
	 * @return int Number of items that were deleted.
	 */
	abstract public function delete( $options );

	/**
	 * Get Success Message.
	 *
	 * @param int $items_deleted Number of items that were deleted.
	 *
	 * @return string Success message.
	 */
	abstract protected function get_success_message( $items_deleted );

	/**
	 * Get Cron Name.
	 *
	 * @return string Cron Name.
	 */
	abstract protected function get_cron_name();

	/**
	 * Create new instances of Modules.
	 */
	public function __construct() {
		$this->initialize();
	}

	/**
	 * Register.
	 *
	 * @param string $hook_suffix Page Hook Suffix.
	 * @param string $page_slug   Page slug.
	 */
	public function register( $hook_suffix, $page_slug ) {
		$this->page_hook_suffix = $hook_suffix;
		$this->page_slug        = $page_slug;

		add_action( "add_meta_boxes_{$this->page_hook_suffix}", array( $this, 'setup_metabox' ) );

		add_action( 'bd_' . $this->action, array( $this, 'process' ) );
		add_filter( 'bd_javascript_array', array( $this, 'filter_js_array' ) );
	}

	/**
	 * Setup the meta box.
	 */
	public function setup_metabox() {
		add_meta_box(
			$this->meta_box_slug,
			$this->messages['box_label'],
			array( $this, 'render_box' ),
			$this->page_hook_suffix,
			'advanced'
		);
	}

	/**
	 * Render the meta box.
	 */
	public function render_box() {
		if ( $this->is_hidden() ) {
			printf(
				/* translators: 1 module url */
				__( 'This section just got enabled. Kindly <a href = "%1$s">refresh</a> the page to fully enable it.', 'bulk-delete' ),
				'admin.php?page=' . $this->page_slug
			);

			return;
		}

		$this->render();
	}

	/**
	 * Is the current meta box hidden by user.
	 *
	 * @return bool True, if hidden. False, otherwise.
	 */
	protected function is_hidden() {
		$current_user    = wp_get_current_user();
		$user_meta_field = $this->get_hidden_box_user_meta_field();
		$hidden_boxes    = get_user_meta( $current_user->ID, $user_meta_field, true );

		return is_array( $hidden_boxes ) && in_array( $this->meta_box_slug, $hidden_boxes, true );
	}

	/**
	 * Get the user meta field that stores the status of the hidden meta boxes.
	 *
	 * @return string Name of the User Meta field.
	 */
	protected function get_hidden_box_user_meta_field() {
		if ( 'posts' === $this->item_type ) {
			return 'metaboxhidden_toplevel_page_bulk-delete-posts';
		} else {
			return 'metaboxhidden_bulk-wp_page_' . $this->page_slug;
		}
	}

	/**
	 * Filter the js array.
	 *
	 * This function will be overridden by the child classes.
	 *
	 * @param array $js_array JavaScript Array.
	 *
	 * @return array Modified JavaScript Array
	 */
	public function filter_js_array( $js_array ) {
		return $js_array;
	}

	/**
	 * Render filtering table header.
	 */
	protected function render_filtering_table_header() {
		bd_render_filtering_table_header();
	}

	/**
	 * Render restrict settings.
	 */
	protected function render_restrict_settings() {
		bd_render_restrict_settings( $this->field_slug, $this->item_type );
	}

	/**
	 * Render delete settings.
	 */
	protected function render_delete_settings() {
		bd_render_delete_settings( $this->field_slug );
	}

	/**
	 * Render limit settings.
	 */
	protected function render_limit_settings() {
		bd_render_limit_settings( $this->field_slug, $this->item_type );
	}

	/**
	 * Render cron settings.
	 */
	protected function render_cron_settings() {
		bd_render_cron_settings( $this->field_slug, $this->scheduler_url );
	}

	/**
	 * Render submit button.
	 */
	protected function render_submit_button() {
		bd_render_submit_button( $this->action );
	}

	/**
	 * Helper function for processing cron filter.
	 *
	 * @param mixed $options
	 */
	protected function process_cron_filters( $options ){
		$options['cron_name'] = $this->get_cron_name();

		return $options;
	}

	/**
	 * Helper function for processing deletion.
	 * Setups up cron and invokes the actual delete method.
	 *
	 * @param array $request Request array.
	 */
	public function process( $request ) {
		$options      = $this->parse_common_filters( $request );
		$options      = $this->convert_user_input_to_options( $request, $options );
		$options      = $this->process_cron_filters( $options );
		$cron_options = $this->parse_cron_filters( $request );

		if ( $this->is_scheduled( $cron_options ) ) {
			$msg = $this->schedule_deletion( $cron_options, $options );
		} else {
			$items_deleted = $this->delete( $options );
			$msg           = sprintf( $this->get_success_message( $items_deleted ), $items_deleted );
		}

		add_settings_error(
			$this->page_slug,
			$this->action,
			$msg,
			'updated'
		);
	}

	/**
	 * Getter for cron_hook.
	 *
	 * @return string Cron Hook name.
	 */
	public function get_cron_hook() {
		return $this->cron_hook;
	}

	/**
	 * Getter for field slug.
	 *
	 * @return string Field Slug.
	 */
	public function get_field_slug() {
		return $this->field_slug;
	}

	/**
	 * Getter for action.
	 *
	 * @return string Modules action.
	 */
	public function get_action() {
		return $this->action;
	}

	/**
	 * Is the current deletion request a scheduled request?
	 *
	 * @param array $cron_options Request object.
	 *
	 * @return bool True if it is a scheduled request, False otherwise.
	 */
	protected function is_scheduled( $cron_options ) {
		return $cron_options['is_scheduled'];
	}

	/**
	 * Schedule Deletion of items.
	 *
	 * @param array $cron_options Cron options.
	 * @param array $options      Deletion option.
	 *
	 * @return string Message.
	 */
	protected function schedule_deletion( $cron_options, $options ) {
		if ( '-1' === $cron_options['frequency'] ) {
			wp_schedule_single_event( $cron_options['start_time'], $this->cron_hook, array( $options ) );
		} else {
			wp_schedule_event( $cron_options['start_time'], $cron_options['frequency'], $this->cron_hook, array( $options ) );
		}

		return $this->messages['scheduled'] . ' ' . $this->get_task_list_link();
	}

	/**
	 * Get the link to the page that lists all the scheduled tasks.
	 *
	 * @return string Link to scheduled tasks page.
	 */
	protected function get_task_list_link() {
		return sprintf(
			__( 'See the full list of <a href = "%s">scheduled tasks</a>', 'bulk-delete' ),
			get_bloginfo( 'wpurl' ) . '/wp-admin/admin.php?page=' . \Bulk_Delete::CRON_PAGE_SLUG
		);
	}

	/**
	 * Handle common filters.
	 *
	 * @param array $request Request array.
	 *
	 * @return array User options.
	 */
	protected function parse_common_filters( $request ) {
		$options = array();

		$options['restrict']     = bd_array_get_bool( $request, 'smbd_' . $this->field_slug . '_restrict', false );
		$options['limit_to']     = absint( bd_array_get( $request, 'smbd_' . $this->field_slug . '_limit_to', 0 ) );
		$options['force_delete'] = bd_array_get_bool( $request, 'smbd_' . $this->field_slug . '_force_delete', false );

		$options['date_op'] = bd_array_get( $request, 'smbd_' . $this->field_slug . '_op' );
		$options['days']    = absint( bd_array_get( $request, 'smbd_' . $this->field_slug . '_days' ) );

		return $options;
	}

	/**
	 * Parse request and create cron options.
	 *
	 * @param array $request Request array.
	 *
	 * @return array Parsed cron option.
	 */
	protected function parse_cron_filters( $request ) {
		$cron_options = array(
			'is_scheduled' => false,
		);

		$scheduled = bd_array_get_bool( $request, 'smbd_' . $this->field_slug . '_cron', false );

		if ( $scheduled ) {
			$cron_options['is_scheduled'] = true;
			$cron_options['frequency']    = sanitize_text_field( $request[ 'smbd_' . $this->field_slug . '_cron_freq' ] );
			$cron_options['start_time']   = bd_get_gmt_offseted_time( sanitize_text_field( $request[ 'smbd_' . $this->field_slug . '_cron_start' ] ) );
		}

		return $cron_options;
	}

	/**
	 * Get the threshold after which enhanced select should be used.
	 *
	 * @return int Threshold.
	 */
	protected function get_enhanced_select_threshold() {
		/**
		 * Filter the enhanced select threshold.
		 *
		 * @since 6.0.0
		 *
		 * @param int Threshold.
		 */
		return apply_filters( 'bd_enhanced_select_threshold', 1000 );
	}

	/**
	 * Get the class name for select2 dropdown based on the number of items present.
	 *
	 * @param int    $count      The number of items present.
	 * @param string $class_name Primary class name.
	 *
	 * @return string Class name.
	 */
	protected function enable_ajax_if_needed_to_dropdown_class_name( $count, $class_name ) {
		if ( $count >= $this->get_enhanced_select_threshold() ) {
			$class_name .= '-ajax';
		}

		return $class_name;
	}
}


1		<?php
2
3		namespace BulkWP\BulkDelete\Core\Base;
4
5		use BulkWP\BulkDelete\Core\Base\Mixin\Renderer;
6
7	1	defined( 'ABSPATH' ) \|\| exit; // Exit if accessed directly.
8
9		/**
10		* Encapsulates the Bulk Delete Meta box Module Logic.
11		*
12		* All Bulk Delete Meta box Modules should extend this class.
13		* This class extends Renderer Mixin class since Bulk Delete still supports PHP 5.3.
14		* Once PHP 5.3 support is dropped, Renderer will be implemented as a Trait and this class will `use` it.
15		*
16		* @since 6.0.0
17		*/
18		abstract class BaseModule extends Renderer {
19		/**
20		* Item Type. Possible values 'posts', 'pages', 'users' etc.
21		*
22		* @var string
23		*/
24		protected $item_type;
25
26		/**
27		* The hook suffix of the screen where this meta box would be shown.
28		*
29		* @var string
30		*/
31		protected $page_hook_suffix;
32
33		/**
34		* Slug of the page where this module will be shown.
35		*
36		* @var string
37		*/
38		protected $page_slug;
39
40		/**
41		* Slug for the form fields.
42		*
43		* @var string
44		*/
45		protected $field_slug;
46
47		/**
48		* Slug of the meta box.
49		*
50		* @var string
51		*/
52		protected $meta_box_slug;
53
54		/**
55		* Action in which the delete operation should be performed.
56		*
57		* @var string
58		*/
59		protected $action;
60
61		/**
62		* Hook for scheduler.
63		*
64		* @var string
65		*/
66		protected $cron_hook;
67
68		/**
69		* Url of the scheduler addon.
70		*
71		* @var string
72		*/
73		protected $scheduler_url;
74
75		/**
76		* Messages shown to the user.
77		*
78		* @var array
79		*/
80		protected $messages = array(
81		'box_label' => '',
82		);
83
84		/**
85		* Initialize and setup variables.
86		*
87		* @return void
88		*/
89		abstract protected function initialize();
90
91		/**
92		* Render the Modules.
93		*
94		* @return void
95		*/
96		abstract public function render();
97
98		/**
99		* Process user input and create metabox options.
100		*
101		* @param array $request Request array.
102		* @param array $options User options.
103		*
104		* @return array User options.
105		*/
106		abstract protected function convert_user_input_to_options( $request, $options );
107
108		/**
109		* Perform the deletion.
110		*
111		* @param array $options Array of Delete options.
112		*
113		* @return int Number of items that were deleted.
114		*/
115		abstract public function delete( $options );
116
117		/**
118		* Get Success Message.
119		*
120		* @param int $items_deleted Number of items that were deleted.
121		*
122		* @return string Success message.
123		*/
124		abstract protected function get_success_message( $items_deleted );
125
126		/**
127		* Get Cron Name.
128		*
129		* @return string Cron Name.
130		*/
131		abstract protected function get_cron_name();
132
133		/**
134		* Create new instances of Modules.
135		*/
136	103	public function __construct() {
137	103	$this->initialize();
138	103	}
139
140		/**
141		* Register.
142		*
143		* @param string $hook_suffix Page Hook Suffix.
144		* @param string $page_slug Page slug.
145		*/
146		public function register( $hook_suffix, $page_slug ) {
147		$this->page_hook_suffix = $hook_suffix;
148		$this->page_slug = $page_slug;
149
150		add_action( "add_meta_boxes_{$this->page_hook_suffix}", array( $this, 'setup_metabox' ) );
151
152		add_action( 'bd_' . $this->action, array( $this, 'process' ) );
153		add_filter( 'bd_javascript_array', array( $this, 'filter_js_array' ) );
154		}
155
156		/**
157		* Setup the meta box.
158		*/
159		public function setup_metabox() {
160		add_meta_box(
161		$this->meta_box_slug,
162		$this->messages['box_label'],
163		array( $this, 'render_box' ),
164		$this->page_hook_suffix,
165		'advanced'
166		);
167		}
168
169		/**
170		* Render the meta box.
171		*/
172	1	public function render_box() {
173	1	if ( $this->is_hidden() ) {
174		printf(
175		/* translators: 1 module url */
176		__( 'This section just got enabled. Kindly <a href = "%1$s">refresh</a> the page to fully enable it.', 'bulk-delete' ),
177		'admin.php?page=' . $this->page_slug
178		);
179
180		return;
181		}
182
183	1	$this->render();
184	1	}
185
186		/**
187		* Is the current meta box hidden by user.
188		*
189		* @return bool True, if hidden. False, otherwise.
190		*/
191	1	protected function is_hidden() {
192	1	$current_user = wp_get_current_user();
193	1	$user_meta_field = $this->get_hidden_box_user_meta_field();
194	1	$hidden_boxes = get_user_meta( $current_user->ID, $user_meta_field, true );
195
196	1	return is_array( $hidden_boxes ) && in_array( $this->meta_box_slug, $hidden_boxes, true );
197		}
198
199		/**
200		* Get the user meta field that stores the status of the hidden meta boxes.
201		*
202		* @return string Name of the User Meta field.
203		*/
204	1	protected function get_hidden_box_user_meta_field() {
205	1	if ( 'posts' === $this->item_type ) {
206		return 'metaboxhidden_toplevel_page_bulk-delete-posts';
207		} else {
208	1	return 'metaboxhidden_bulk-wp_page_' . $this->page_slug;
209		}
210		}
211
212		/**
213		* Filter the js array.
214		*
215		* This function will be overridden by the child classes.
216		*
217		* @param array $js_array JavaScript Array.
218		*
219		* @return array Modified JavaScript Array
220		*/
221		public function filter_js_array( $js_array ) {
222		return $js_array;
223		}
224
225		/**
226		* Render filtering table header.
227		*/
228		protected function render_filtering_table_header() {
229		bd_render_filtering_table_header();
230		}
231
232		/**
233		* Render restrict settings.
234		*/
235		protected function render_restrict_settings() {
236		bd_render_restrict_settings( $this->field_slug, $this->item_type );
237		}
238
239		/**
240		* Render delete settings.
241		*/
242		protected function render_delete_settings() {
243		bd_render_delete_settings( $this->field_slug );
244		}
245
246		/**
247		* Render limit settings.
248		*/
249		protected function render_limit_settings() {
250		bd_render_limit_settings( $this->field_slug, $this->item_type );
251		}
252
253		/**
254		* Render cron settings.
255		*/
256		protected function render_cron_settings() {
257		bd_render_cron_settings( $this->field_slug, $this->scheduler_url );
258		}
259
260		/**
261		* Render submit button.
262		*/
263		protected function render_submit_button() {
264		bd_render_submit_button( $this->action );
265		}
266
267		/**
268		* Helper function for processing cron filter.
269		*
270		* @param mixed $options
271		*/
272	1	protected function process_cron_filters( $options ){
273	1	$options['cron_name'] = $this->get_cron_name();
274
275	1	return $options;
276		}
277
278		/**
279		* Helper function for processing deletion.
280		* Setups up cron and invokes the actual delete method.
281		*
282		* @param array $request Request array.
283		*/
284	1	public function process( $request ) {
285	1	$options = $this->parse_common_filters( $request );
286	1	$options = $this->convert_user_input_to_options( $request, $options );
287	1	$options = $this->process_cron_filters( $options );
288	1	$cron_options = $this->parse_cron_filters( $request );
289
290	1	if ( $this->is_scheduled( $cron_options ) ) {
291		$msg = $this->schedule_deletion( $cron_options, $options );
292		} else {
293	1	$items_deleted = $this->delete( $options );
294	1	$msg = sprintf( $this->get_success_message( $items_deleted ), $items_deleted );
295		}
296
297	1	add_settings_error(
298	1	$this->page_slug,
299	1	$this->action,
300	1	$msg,
301	1	'updated'
302		);
303	1	}
304
305		/**
306		* Getter for cron_hook.
307		*
308		* @return string Cron Hook name.
309		*/
310		public function get_cron_hook() {
311		return $this->cron_hook;
312		}
313
314		/**
315		* Getter for field slug.
316		*
317		* @return string Field Slug.
318		*/
319		public function get_field_slug() {
320		return $this->field_slug;
321		}
322
323		/**
324		* Getter for action.
325		*
326		* @return string Modules action.
327		*/
328	36	public function get_action() {
329	36	return $this->action;
330		}
331
332		/**
333		* Is the current deletion request a scheduled request?
334		*
335		* @param array $cron_options Request object.
336		*
337		* @return bool True if it is a scheduled request, False otherwise.
338		*/
339	3	protected function is_scheduled( $cron_options ) {
340	3	return $cron_options['is_scheduled'];
341		}
342
343		/**
344		* Schedule Deletion of items.
345		*
346		* @param array $cron_options Cron options.
347		* @param array $options Deletion option.
348		*
349		* @return string Message.
350		*/
351	32	protected function schedule_deletion( $cron_options, $options ) {
352	32	if ( '-1' === $cron_options['frequency'] ) {
353	8	wp_schedule_single_event( $cron_options['start_time'], $this->cron_hook, array( $options ) );
354		} else {
355	24	wp_schedule_event( $cron_options['start_time'], $cron_options['frequency'], $this->cron_hook, array( $options ) );
356		}
357
358	32	return $this->messages['scheduled'] . ' ' . $this->get_task_list_link();
359		}
360
361		/**
362		* Get the link to the page that lists all the scheduled tasks.
363		*
364		* @return string Link to scheduled tasks page.
365		*/
366	32	protected function get_task_list_link() {
367	32	return sprintf(
368	32	__( 'See the full list of <a href = "%s">scheduled tasks</a>', 'bulk-delete' ),
369	32	get_bloginfo( 'wpurl' ) . '/wp-admin/admin.php?page=' . \Bulk_Delete::CRON_PAGE_SLUG
370		);
371		}
372
373		/**
374		* Handle common filters.
375		*
376		* @param array $request Request array.
377		*
378		* @return array User options.
379		*/
380	1	protected function parse_common_filters( $request ) {
381	1	$options = array();
382
383	1	$options['restrict'] = bd_array_get_bool( $request, 'smbd_' . $this->field_slug . '_restrict', false );
384	1	$options['limit_to'] = absint( bd_array_get( $request, 'smbd_' . $this->field_slug . '_limit_to', 0 ) );
385	1	$options['force_delete'] = bd_array_get_bool( $request, 'smbd_' . $this->field_slug . '_force_delete', false );
386
387	1	$options['date_op'] = bd_array_get( $request, 'smbd_' . $this->field_slug . '_op' );
388	1	$options['days'] = absint( bd_array_get( $request, 'smbd_' . $this->field_slug . '_days' ) );
389
390	1	return $options;
391		}
392
393		/**
394		* Parse request and create cron options.
395		*
396		* @param array $request Request array.
397		*
398		* @return array Parsed cron option.
399		*/
400	31	protected function parse_cron_filters( $request ) {
401		$cron_options = array(
402	31	'is_scheduled' => false,
403		);
404
405	31	$scheduled = bd_array_get_bool( $request, 'smbd_' . $this->field_slug . '_cron', false );
406
407	31	if ( $scheduled ) {
408	28	$cron_options['is_scheduled'] = true;
409	28	$cron_options['frequency'] = sanitize_text_field( $request[ 'smbd_' . $this->field_slug . '_cron_freq' ] );
410	28	$cron_options['start_time'] = bd_get_gmt_offseted_time( sanitize_text_field( $request[ 'smbd_' . $this->field_slug . '_cron_start' ] ) );
411		}
412
413	31	return $cron_options;
414		}
415
416		/**
417		* Get the threshold after which enhanced select should be used.
418		*
419		* @return int Threshold.
420		*/
421		protected function get_enhanced_select_threshold() {
422		/**
423		* Filter the enhanced select threshold.
424		*
425		* @since 6.0.0
426		*
427		* @param int Threshold.
428		*/
429		return apply_filters( 'bd_enhanced_select_threshold', 1000 );
430		}
431
432		/**
433		* Get the class name for select2 dropdown based on the number of items present.
434		*
435		* @param int $count The number of items present.
436		* @param string $class_name Primary class name.
437		*
438		* @return string Class name.
439		*/
440		protected function enable_ajax_if_needed_to_dropdown_class_name( $count, $class_name ) {
441		if ( $count >= $this->get_enhanced_select_threshold() ) {
442		$class_name .= '-ajax';
443		}
444
445		return $class_name;
446		}
447		}
448

sudar / bulk-delete

Push — analysis-8bk1ra ( 2917e1 )

BaseModule::__construct() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like