|
1
|
|
|
<?php |
|
|
|
|
|
|
2
|
|
|
namespace GV\Shortcodes; |
|
3
|
|
|
|
|
4
|
|
|
/** If this file is called directly, abort. */ |
|
5
|
|
|
if ( ! defined( 'GRAVITYVIEW_DIR' ) ) { |
|
6
|
|
|
die(); |
|
7
|
|
|
} |
|
8
|
|
|
|
|
9
|
|
|
/** |
|
10
|
|
|
* The [gravityview] shortcode. |
|
11
|
|
|
*/ |
|
12
|
|
|
class gravityview extends \GV\Shortcode { |
|
|
|
|
|
|
13
|
|
|
/** |
|
14
|
|
|
* {@inheritDoc} |
|
15
|
|
|
*/ |
|
16
|
|
|
public $name = 'gravityview'; |
|
17
|
|
|
|
|
18
|
|
|
/** |
|
19
|
|
|
* Process and output the [gravityview] shortcode. |
|
20
|
|
|
* |
|
21
|
|
|
* @param array $passed_atts The attributes passed. |
|
22
|
|
|
* @param string $content The content inside the shortcode. |
|
23
|
|
|
* |
|
24
|
|
|
* @return string|null The output. |
|
25
|
|
|
*/ |
|
26
|
6 |
|
public function callback( $passed_atts, $content = null ) { |
|
27
|
|
|
|
|
28
|
6 |
|
$request = gravityview()->request; |
|
29
|
|
|
|
|
30
|
6 |
|
if ( $request->is_admin() ) { |
|
31
|
|
|
return ''; |
|
32
|
|
|
} |
|
33
|
|
|
|
|
34
|
6 |
|
$atts = wp_parse_args( $passed_atts, array( |
|
35
|
6 |
|
'id' => 0, |
|
36
|
|
|
'view_id' => 0, |
|
37
|
|
|
'detail' => null, |
|
38
|
|
|
) ); |
|
39
|
|
|
|
|
40
|
6 |
|
if ( ! $view_id = $atts['id'] ? : $atts['view_id'] ) { |
|
41
|
|
|
if ( $atts['detail'] && $view = $request->is_view() ) { |
|
42
|
|
|
$view_id = $view->ID; |
|
|
|
|
|
|
43
|
|
|
} |
|
44
|
|
|
} |
|
45
|
|
|
|
|
46
|
6 |
|
$view = \GV\View::by_id( $view_id ); |
|
47
|
|
|
|
|
48
|
6 |
|
if ( ! $view ) { |
|
49
|
|
|
gravityview()->log->error( 'View does not exist #{view_id}', array( 'view_id' => $view_id ) ); |
|
50
|
|
|
return ''; |
|
51
|
|
|
} |
|
52
|
|
|
|
|
53
|
6 |
|
gravityview()->views->set( $view ); |
|
|
|
|
|
|
54
|
|
|
|
|
55
|
|
|
/** |
|
56
|
|
|
* When this shortcode is embedded inside a View we can only display it as a directory. There's no other way. |
|
57
|
|
|
* Try to detect that we're not embedded to allow edit and single contexts. |
|
58
|
|
|
*/ |
|
59
|
6 |
|
$is_reembedded = false; // Assume not embedded unless detected otherwise. |
|
60
|
6 |
|
if ( in_array( get_class( $request ), array( 'GV\Frontend_Request', 'GV\Mock_Request' ) ) ) { |
|
61
|
6 |
|
if ( ( $_view = $request->is_view() ) && $_view->ID !== $view->ID ) { |
|
|
|
|
|
|
62
|
|
|
$is_reembedded = true; |
|
63
|
|
|
} |
|
64
|
|
|
|
|
65
|
6 |
|
if ( ( ! $_view ) && $request->is_entry() ) { |
|
66
|
1 |
|
$is_reembedded = true; // This shortcode is embedded in an entry... |
|
67
|
|
|
} |
|
68
|
|
|
} |
|
69
|
|
|
|
|
70
|
|
|
/** |
|
71
|
|
|
* Remove Widgets on a nested embedded View. |
|
72
|
|
|
*/ |
|
73
|
6 |
|
if ( $is_reembedded ) { |
|
74
|
1 |
|
$view->widgets = new \GV\Widget_Collection(); |
|
75
|
|
|
} |
|
76
|
|
|
|
|
77
|
6 |
|
$atts = $this->parse_and_sanitize_atts( $atts ); |
|
78
|
|
|
|
|
79
|
6 |
|
$view->settings->update( $atts ); |
|
80
|
6 |
|
$entries = $view->get_entries( $request ); |
|
81
|
|
|
|
|
82
|
|
|
/** |
|
83
|
|
|
* Check permissions. |
|
84
|
|
|
*/ |
|
85
|
6 |
|
while ( $error = $view->can_render( array( 'shortcode' ), $request ) ) { |
|
86
|
1 |
|
if ( ! is_wp_error( $error ) ) |
|
|
|
|
|
|
87
|
|
|
break; |
|
88
|
|
|
|
|
89
|
1 |
|
switch ( str_replace( 'gravityview/', '', $error->get_error_code() ) ) { |
|
90
|
1 |
|
case 'post_password_required': |
|
91
|
1 |
|
return get_the_password_form( $view->ID ); |
|
|
|
|
|
|
92
|
1 |
|
case 'no_form_attached': |
|
93
|
|
|
/** |
|
94
|
|
|
* This View has no data source. There's nothing to show really. |
|
95
|
|
|
* ...apart from a nice message if the user can do anything about it. |
|
96
|
|
|
*/ |
|
97
|
|
|
if ( \GVCommon::has_cap( array( 'edit_gravityviews', 'edit_gravityview' ), $view->ID ) ) { |
|
|
|
|
|
|
98
|
|
|
return __( sprintf( 'This View is not configured properly. Start by <a href="%s">selecting a form</a>.', esc_url( get_edit_post_link( $view->ID, false ) ) ), 'gravityview' ); |
|
|
|
|
|
|
99
|
|
|
} |
|
100
|
|
|
break; |
|
101
|
1 |
|
case 'no_direct_access': |
|
102
|
1 |
|
case 'embed_only': |
|
103
|
1 |
|
case 'not_public': |
|
104
|
1 |
|
return __( 'You are not allowed to view this content.', 'gravityview' ); |
|
105
|
|
|
} |
|
106
|
|
|
} |
|
107
|
|
|
|
|
108
|
6 |
|
$is_admin_and_can_view = $view->settings->get( 'admin_show_all_statuses' ) && \GVCommon::has_cap('gravityview_moderate_entries', $view->ID ); |
|
|
|
|
|
|
109
|
|
|
|
|
110
|
|
|
/** |
|
111
|
|
|
* View details. |
|
112
|
|
|
*/ |
|
113
|
6 |
|
if ( $atts['detail'] ) { |
|
114
|
2 |
|
return $this->detail( $view, $entries, $atts ); |
|
115
|
|
|
|
|
116
|
|
|
/** |
|
117
|
|
|
* Editing a single entry. |
|
118
|
|
|
*/ |
|
119
|
5 |
|
} else if ( ! $is_reembedded && ( $entry = $request->is_edit_entry() ) ) { |
|
120
|
|
|
|
|
121
|
|
|
/** |
|
122
|
|
|
* When editing an entry don't render multiple views. |
|
123
|
|
|
*/ |
|
124
|
|
|
if ( ( $selected = \GV\Utils::_GET( 'gvid' ) ) && $view->ID != $selected ) { |
|
|
|
|
|
|
125
|
|
|
gravityview()->log->notice( 'Entry ID #{entry_id} not rendered because another View ID was passed using `?gvid`: #{selected}', array( 'entry_id' => $entry->ID, 'selected' => $selected ) ); |
|
126
|
|
|
return ''; |
|
127
|
|
|
} |
|
128
|
|
|
|
|
129
|
|
|
if ( $entry['status'] != 'active' ) { |
|
|
|
|
|
|
130
|
|
|
gravityview()->log->notice( 'Entry ID #{entry_id} is not active', array( 'entry_id' => $entry->ID ) ); |
|
131
|
|
|
return __( 'You are not allowed to view this content.', 'gravityview' ); |
|
132
|
|
|
} |
|
133
|
|
|
|
|
134
|
|
|
if ( apply_filters( 'gravityview_custom_entry_slug', false ) && $entry->slug != get_query_var( \GV\Entry::get_endpoint_name() ) ) { |
|
135
|
|
|
gravityview()->log->error( 'Entry ID #{entry_id} was accessed by a bad slug', array( 'entry_id' => $entry->ID ) ); |
|
136
|
|
|
return __( 'You are not allowed to view this content.', 'gravityview' ); |
|
137
|
|
|
} |
|
138
|
|
|
|
|
139
|
|
|
if ( $view->settings->get( 'show_only_approved' ) && ! $is_admin_and_can_view ) { |
|
140
|
|
|
if ( ! \GravityView_Entry_Approval_Status::is_approved( gform_get_meta( $entry->ID, \GravityView_Entry_Approval::meta_key ) ) ) { |
|
141
|
|
|
gravityview()->log->error( 'Entry ID #{entry_id} is not approved for viewing', array( 'entry_id' => $entry->ID ) ); |
|
142
|
|
|
return __( 'You are not allowed to view this content.', 'gravityview' ); |
|
143
|
|
|
} |
|
144
|
|
|
} |
|
145
|
|
|
|
|
146
|
|
|
$renderer = new \GV\Edit_Entry_Renderer(); |
|
147
|
|
|
return $renderer->render( $entry, $view, $request ); |
|
148
|
|
|
|
|
149
|
|
|
/** |
|
150
|
|
|
* Viewing a single entry. |
|
151
|
|
|
*/ |
|
152
|
5 |
|
} else if ( ! $is_reembedded && ( $entry = $request->is_entry() ) ) { |
|
153
|
|
|
/** |
|
154
|
|
|
* When viewing an entry don't render multiple views. |
|
155
|
|
|
*/ |
|
156
|
1 |
|
if ( ( $selected = \GV\Utils::_GET( 'gvid' ) ) && $view->ID != $selected ) { |
|
|
|
|
|
|
157
|
|
|
return ''; |
|
158
|
|
|
} |
|
159
|
|
|
|
|
160
|
1 |
|
if ( $entry['status'] != 'active' ) { |
|
|
|
|
|
|
161
|
1 |
|
gravityview()->log->notice( 'Entry ID #{entry_id} is not active', array( 'entry_id' => $entry->ID ) ); |
|
162
|
1 |
|
return __( 'You are not allowed to view this content.', 'gravityview' ); |
|
163
|
|
|
} |
|
164
|
|
|
|
|
165
|
1 |
|
if ( apply_filters( 'gravityview_custom_entry_slug', false ) && $entry->slug != get_query_var( \GV\Entry::get_endpoint_name() ) ) { |
|
166
|
1 |
|
gravityview()->log->error( 'Entry ID #{entry_id} was accessed by a bad slug', array( 'entry_id' => $entry->ID ) ); |
|
167
|
1 |
|
return __( 'You are not allowed to view this content.', 'gravityview' ); |
|
168
|
|
|
} |
|
169
|
|
|
|
|
170
|
1 |
|
if ( $view->settings->get( 'show_only_approved' ) && ! $is_admin_and_can_view ) { |
|
171
|
1 |
|
if ( ! \GravityView_Entry_Approval_Status::is_approved( gform_get_meta( $entry->ID, \GravityView_Entry_Approval::meta_key ) ) ) { |
|
172
|
1 |
|
gravityview()->log->error( 'Entry ID #{entry_id} is not approved for viewing', array( 'entry_id' => $entry->ID ) ); |
|
173
|
1 |
|
return __( 'You are not allowed to view this content.', 'gravityview' ); |
|
174
|
|
|
} |
|
175
|
|
|
} |
|
176
|
|
|
|
|
177
|
1 |
|
$error = \GVCommon::check_entry_display( $entry->as_entry() ); |
|
178
|
|
|
|
|
179
|
1 |
|
if( is_wp_error( $error ) ) { |
|
180
|
1 |
|
gravityview()->log->error( 'Entry ID #{entry_id} is not approved for viewing: {message}', array( 'entry_id' => $entry->ID, 'message' => $error->get_error_message() ) ); |
|
181
|
1 |
|
return __( 'You are not allowed to view this content.', 'gravityview' ); |
|
182
|
|
|
} |
|
183
|
|
|
|
|
184
|
1 |
|
$renderer = new \GV\Entry_Renderer(); |
|
185
|
1 |
|
return $renderer->render( $entry, $view, $request ); |
|
186
|
|
|
|
|
187
|
|
|
/** |
|
188
|
|
|
* Just this view. |
|
189
|
|
|
*/ |
|
190
|
|
|
} else { |
|
191
|
4 |
|
if ( $is_reembedded ) { |
|
192
|
|
|
|
|
193
|
|
|
// Mock the request with the actual View, not the global one |
|
194
|
1 |
|
$mock_request = new \GV\Mock_Request(); |
|
195
|
1 |
|
$mock_request->returns['is_view'] = $view; |
|
196
|
1 |
|
$mock_request->returns['is_entry'] = $request->is_entry(); |
|
197
|
1 |
|
$mock_request->returns['is_edit_entry'] = $request->is_edit_entry(); |
|
198
|
1 |
|
$mock_request->returns['is_search'] = $request->is_search(); |
|
199
|
|
|
|
|
200
|
1 |
|
$request = $mock_request; |
|
201
|
|
|
} |
|
202
|
|
|
|
|
203
|
4 |
|
$renderer = new \GV\View_Renderer(); |
|
204
|
4 |
|
return $renderer->render( $view, $request ); |
|
205
|
|
|
} |
|
206
|
|
|
} |
|
207
|
|
|
|
|
208
|
|
|
/** |
|
209
|
|
|
* Validate attributes passed to the [gravityview] shortcode. Supports {get} Merge Tags values. |
|
210
|
|
|
* |
|
211
|
|
|
* Attributes passed to the shortcode are compared to registered attributes {@see \GV\View_Settings::defaults} |
|
212
|
|
|
* Only attributes that are defined will be allowed through. |
|
213
|
|
|
* |
|
214
|
|
|
* Then, {get} merge tags are replaced with their $_GET values, if passed |
|
215
|
|
|
* |
|
216
|
|
|
* Then, attributes are sanitized based on the type of setting (number, checkbox, select, radio, text) |
|
217
|
|
|
* |
|
218
|
|
|
* @see \GV\View_Settings::defaults() Only attributes defined in default() are valid to be passed via the shortcode |
|
219
|
|
|
* |
|
220
|
|
|
* @param array $passed_atts Attribute pairs defined to render the View |
|
221
|
|
|
* |
|
222
|
|
|
* @return array Valid and sanitized attribute pairs |
|
223
|
|
|
*/ |
|
224
|
5 |
|
private function parse_and_sanitize_atts( $passed_atts ) { |
|
225
|
|
|
|
|
226
|
5 |
|
$defaults = \GV\View_Settings::defaults( true ); |
|
227
|
|
|
|
|
228
|
5 |
|
$supported_atts = array_fill_keys( array_keys( $defaults ), '' ); |
|
229
|
|
|
|
|
230
|
|
|
// Whittle down the attributes to only valid pairs |
|
231
|
5 |
|
$filtered_atts = shortcode_atts( $supported_atts, $passed_atts, 'gravityview' ); |
|
232
|
|
|
|
|
233
|
|
|
// Only keep the passed attributes after making sure that they're valid pairs |
|
234
|
5 |
|
$filtered_atts = array_intersect_key( (array) $passed_atts, $filtered_atts ); |
|
235
|
|
|
|
|
236
|
5 |
|
$atts = array(); |
|
237
|
|
|
|
|
238
|
5 |
|
foreach( $filtered_atts as $key => $passed_value ) { |
|
239
|
|
|
|
|
240
|
|
|
// Allow using GravityView merge tags in shortcode attributes, like {get} and {created_by} |
|
241
|
5 |
|
$passed_value = \GravityView_Merge_Tags::replace_variables( $passed_value ); |
|
242
|
|
|
|
|
243
|
5 |
|
switch( $defaults[ $key ]['type'] ) { |
|
244
|
|
|
|
|
245
|
|
|
/** |
|
246
|
|
|
* Make sure number fields are numeric. |
|
247
|
|
|
* Also, convert mixed number strings to numbers |
|
248
|
|
|
* @see http://php.net/manual/en/function.is-numeric.php#107326 |
|
249
|
|
|
*/ |
|
250
|
5 |
|
case 'number': |
|
251
|
5 |
|
if( is_numeric( $passed_value ) ) { |
|
252
|
5 |
|
$atts[ $key ] = ( $passed_value + 0 ); |
|
253
|
|
|
} |
|
254
|
5 |
|
break; |
|
255
|
|
|
|
|
256
|
|
|
// Checkboxes should be 1 or 0 |
|
257
|
1 |
|
case 'checkbox': |
|
258
|
|
|
$atts[ $key ] = gv_empty( $passed_value, true, false ) ? 0 : 1; |
|
259
|
|
|
break; |
|
260
|
|
|
|
|
261
|
|
|
/** |
|
262
|
|
|
* Only allow values that are defined in the settings |
|
263
|
|
|
*/ |
|
264
|
1 |
|
case 'select': |
|
265
|
1 |
|
case 'radio': |
|
266
|
|
|
$options = isset( $defaults[ $key ]['choices'] ) ? $defaults[ $key ]['choices'] : $defaults[ $key ]['options']; |
|
267
|
|
|
if( in_array( $passed_value, array_keys( $options ) ) ) { |
|
268
|
|
|
$atts[ $key ] = $passed_value; |
|
269
|
|
|
} |
|
270
|
|
|
break; |
|
271
|
|
|
|
|
272
|
1 |
|
case 'text': |
|
273
|
|
|
default: |
|
274
|
1 |
|
$atts[ $key ] = $passed_value; |
|
275
|
5 |
|
break; |
|
276
|
|
|
} |
|
277
|
|
|
} |
|
278
|
|
|
|
|
279
|
5 |
|
$atts['detail'] = \GV\Utils::get( $passed_atts, 'detail', null ); |
|
280
|
|
|
|
|
281
|
5 |
|
return $atts; |
|
282
|
|
|
} |
|
283
|
|
|
|
|
284
|
|
|
/** |
|
285
|
|
|
* Output view details. |
|
286
|
|
|
* |
|
287
|
|
|
* @param \GV\View $view The View. |
|
288
|
|
|
* @param \GV\Entry_Collection $entries The calculated entries. |
|
289
|
|
|
* @param array $atts The shortcode attributes (with defaults). |
|
290
|
|
|
* |
|
291
|
|
|
* @return string The output. |
|
292
|
|
|
*/ |
|
293
|
1 |
|
private function detail( $view, $entries, $atts ) { |
|
294
|
1 |
|
$output = ''; |
|
295
|
|
|
|
|
296
|
1 |
|
switch ( $key = $atts['detail'] ): |
|
297
|
1 |
|
case 'total_entries': |
|
298
|
1 |
|
$output = number_format_i18n( $entries->total() ); |
|
299
|
1 |
|
break; |
|
300
|
|
|
case 'first_entry': |
|
301
|
|
|
$output = number_format_i18n( min( $entries->total(), $view->settings->get( 'offset' ) + 1 ) ); |
|
302
|
|
|
break; |
|
303
|
|
|
case 'last_entry': |
|
304
|
|
|
$output = number_format_i18n( $view->settings->get( 'page_size' ) + $view->settings->get( 'offset' ) ); |
|
305
|
|
|
break; |
|
306
|
|
|
case 'page_size': |
|
307
|
|
|
$output = number_format_i18n( $view->settings->get( $key ) ); |
|
308
|
|
|
break; |
|
309
|
|
|
endswitch; |
|
310
|
|
|
|
|
311
|
|
|
/** |
|
312
|
|
|
* @filter `gravityview/shortcode/detail/{$detail}` Filter the detail output returned from `[gravityview detail="$detail"]` |
|
313
|
|
|
* @since 1.13 |
|
314
|
|
|
* @param string[in,out] $output Existing output |
|
|
|
|
|
|
315
|
|
|
* |
|
316
|
|
|
* @since 2.0.3 |
|
317
|
|
|
* @param \GV\View $view The view. |
|
318
|
|
|
* @param \GV\Entry_Collection $entries The entries. |
|
319
|
|
|
* @param array $atts The shortcode atts with defaults. |
|
320
|
|
|
*/ |
|
321
|
1 |
|
$output = apply_filters( "gravityview/shortcode/detail/$key", $output, $view ); |
|
322
|
|
|
|
|
323
|
1 |
|
return $output; |
|
324
|
|
|
} |
|
325
|
|
|
} |
|
326
|
|
|
|
gravityview /
GravityView
Loading history...
The PSR-1: Basic Coding Standard recommends that a file should either introduce new symbols, that is classes, functions, constants or similar, or have side effects. Side effects are anything that executes logic, like for example printing output, changing ini settings or writing to a file.
The idea behind this recommendation is that merely auto-loading a class should not change the state of an application. It also promotes a cleaner style of programming and makes your code less prone to errors, because the logic is not spread out all over the place.
To learn more about the PSR-1, please see the PHP-FIG site on the PSR-1.