bbp-core / includes / features / bbp_voting / helpers.php

helpers.php in Forumax – AI Powered Advanced Community Forum Plugin 2.0.0, at includes/features/bbp_voting/helpers.php

157 lines 5.5 KB

Raw Download Zip

1	<?php
2	if ( ! defined( 'ABSPATH' ) ) {
3	exit; // Exit if accessed directly.
4	}
5
6	if ( ! function_exists( 'bbp_voting_get_plugin_install_link' ) ) {
7	function bbp_voting_get_plugin_install_link( $plugin, $action = 'install-plugin' ) {
8	return esc_url(
9	wp_nonce_url(
10	add_query_arg(
11	[
12	'action' => $action,
13	'plugin' => $plugin,
14	],
15	admin_url( 'update.php' )
16	),
17	$action . '_' . $plugin
18	)
19	);
20	}
21	}
22
23
24	if ( ! function_exists( 'bbp_voting_get_plugin_activate_link' ) ) {
25	function bbp_voting_get_plugin_activate_link( $plugin, $action = 'activate' ) {
26	if ( strpos( $plugin, '/' ) ) {
27	$plugin = str_replace( '\/', '%2F', $plugin );
28	}
29	$url = sprintf( admin_url( 'plugins.php?action=' . $action . '&plugin=%s&plugin_status=all&paged=1&s' ), $plugin );
30	$_REQUEST['plugin'] = $plugin;
31	$url = wp_nonce_url( $url, $action . '-plugin_' . $plugin );
32	return $url;
33	}
34	}
35
36
37	if ( ! function_exists( 'bbp_voting_field' ) ) {
38	function bbp_voting_field( $key, $name, $label = '', $description = '', $type = 'bool', $pro = false ) {
39	$name_and_id = 'name="' . esc_attr( $key ) . '" id="' . esc_attr( $key ) . '"';
40	$teaser = defined( 'BBPVOTINGPRO' ) ? false : $pro;
41	$attributes = $teaser ? 'disabled' : $name_and_id;
42	?>
43	<tr valign="top">
44	<th scope="row">
45	<?php echo esc_html( $name ); ?>:
46	<?php if ( $pro ) { ?>
47	<a href="<?php echo esc_url( 'https://wpforthewin.com/product/bbpress-voting-pro/' ); ?>" target="_blank" rel="noopener noreferrer">
48	<span class="bbp-voting-pro-badge bbp-voting-pro-green">Pro</span>
49	</a>
50	<?php } ?>
51	</th>
52	<td>
53	<?php if ( $type === 'bool' ) { ?>
54	<input type="checkbox" <?php echo wp_kses_post( $attributes ); ?> value="true"
55	<?php checked( get_option( $key ), 'true' ); ?> />
56	<?php } elseif ( is_array( $type ) ) { ?>
57	<select <?php echo wp_kses_post( $attributes ); ?>>
58	<?php foreach ( $type as $option ) { ?>
59	<option value="<?php echo esc_attr( $option ); ?>" <?php selected( get_option( $key ), $option ); ?>>
60	<?php echo esc_html( ucwords( str_replace( '-', ' ', $option ) ) ); ?>
61	</option>
62	<?php } ?>
63	</select>
64	<?php } else { ?>
65	<input type="<?php echo esc_attr( $type ); ?>" <?php echo wp_kses_post( $attributes ); ?>
66	value="<?php echo esc_attr( get_option( $key ) ); ?>" data-lpignore="true" />
67	<?php } ?>
68
69	<?php if ( ! empty( $label ) ) { ?>
70	<label for="<?php echo esc_attr( $key ); ?>"><?php echo esc_html( $label ); ?></label>
71	<?php } ?>
72
73	<?php if ( ! empty( $description ) ) { ?>
74	<p class="description"><?php echo wp_kses_post( $description ); ?></p>
75	<?php } ?>
76	</td>
77	</tr>
78	<?php
79	}
80	}
81
82	if ( ! function_exists( 'bbp_voting_get_current_post_type' ) ) {
83	function bbp_voting_get_current_post_type() {
84	$this_post_id = bbp_get_reply_id() ?: bbp_get_topic_id();
85	return get_post_type( $this_post_id );
86	}
87	}
88
89	if ( ! function_exists( 'bbp_voting_get_post_type_by_id' ) ) {
90	function bbp_voting_get_post_type_by_id( $post_id ) {
91	$this_post_id = bbp_get_reply_id( $post_id ) ?: bbp_get_topic_id( $post_id );
92	return get_post_type( $this_post_id );
93	}
94	}
95
96	if ( ! class_exists( 'WilsonConfidenceIntervalCalculator' ) ) {
97	class WilsonConfidenceIntervalCalculator {
98	/**
99	* Computed value for confidence (z)
100	*
101	* These values were computed using Ruby's Statistics2.pnormaldist function
102	* 1.645 = 90% confidence
103	* 1.959964 = 95.0% confidence
104	* 2.241403 = 97.5% confidence
105	*/
106	public function getScore( int $positiveVotes, int $totalVotes, float $confidence = 1.645 ) : float {
107	return (float) $totalVotes ? $this->lowerBound( $positiveVotes, $totalVotes, $confidence ) : 0;
108	}
109	private function lowerBound( int $positiveVotes, int $totalVotes, float $confidence ) : float {
110	$phat = 1.0 * $positiveVotes / $totalVotes;
111	$numerator = $this->calculationNumerator( $totalVotes, $confidence, $phat );
112	$denominator = $this->calculationDenominator( $totalVotes, $confidence );
113	return $numerator / $denominator;
114	}
115	private function calculationDenominator( int $total, float $z ) : float {
116	return 1 + $z * $z / $total;
117	}
118	private function calculationNumerator( int $total, float $z, float $phat ) : float {
119	return $phat + $z * $z / ( 2 * $total ) - $z * sqrt( ( $phat * ( 1 - $phat ) + $z * $z / ( 4 * $total ) ) / $total );
120	}
121	}
122	}
123
124
125	if ( ! function_exists( 'bbp_voting_parse_args' ) ) {
126	function bbp_voting_parse_args( $args, $defaults = [], $filter_key = '' ) {
127
128	// Setup a temporary array from $args
129	if ( is_object( $args ) ) {
130	$r = get_object_vars( $args );
131	} elseif ( is_array( $args ) ) {
132	$r =& $args;
133	} else {
134	$r = [];
135	wp_parse_str( $args, $r );
136	}
137
138	// Passively filter the args before the parse
139	if ( ! empty( $filter_key ) ) {
140	$r = apply_filters( "bbp_voting_before_{$filter_key}_parse_args", $r, $args, $defaults );
141	}
142
143	// Parse
144	if ( is_array( $defaults ) && ! empty( $defaults ) ) {
145	$r = array_merge( $defaults, $r );
146	}
147
148	// Aggressively filter the args after the parse
149	if ( ! empty( $filter_key ) ) {
150	$r = apply_filters( "bbp_voting_after_{$filter_key}_parse_args", $r, $args, $defaults );
151	}
152
153	// Return the parsed results
154	return $r;
155	}
156	}
157