1
|
|
|
<?php |
|
|
|
|
2
|
|
|
|
3
|
|
|
/* |
4
|
|
|
* ACF WYSIWYG Field Class |
5
|
|
|
* |
6
|
|
|
* All the logic for this field type |
7
|
|
|
* |
8
|
|
|
* @class acf_field_wysiwyg |
9
|
|
|
* @extends acf_field |
10
|
|
|
* @package ACF |
11
|
|
|
* @subpackage Fields |
12
|
|
|
*/ |
13
|
|
|
|
14
|
|
|
if( ! class_exists('acf_field_wysiwyg') ) : |
15
|
|
|
|
16
|
|
|
class acf_field_wysiwyg extends acf_field { |
|
|
|
|
17
|
|
|
|
18
|
|
|
var $exists = 0; |
|
|
|
|
19
|
|
|
|
20
|
|
|
/* |
21
|
|
|
* __construct |
22
|
|
|
* |
23
|
|
|
* This function will setup the field type data |
24
|
|
|
* |
25
|
|
|
* @type function |
26
|
|
|
* @date 5/03/2014 |
27
|
|
|
* @since 5.0.0 |
28
|
|
|
* |
29
|
|
|
* @param n/a |
30
|
|
|
* @return n/a |
31
|
|
|
*/ |
|
|
|
|
32
|
|
|
|
33
|
|
|
function __construct() { |
|
|
|
|
34
|
|
|
|
35
|
|
|
// vars |
36
|
|
|
$this->name = 'wysiwyg'; |
|
|
|
|
37
|
|
|
$this->label = __("Wysiwyg Editor",'acf'); |
|
|
|
|
38
|
|
|
$this->category = 'content'; |
|
|
|
|
39
|
|
|
$this->defaults = array( |
|
|
|
|
40
|
|
|
'tabs' => 'all', |
41
|
|
|
'toolbar' => 'full', |
42
|
|
|
'media_upload' => 1, |
43
|
|
|
'default_value' => '', |
44
|
|
|
); |
45
|
|
|
|
46
|
|
|
|
47
|
|
|
// Create an acf version of the_content filter (acf_the_content) |
48
|
|
|
if( !empty($GLOBALS['wp_embed']) ) { |
49
|
|
|
|
50
|
|
|
add_filter( 'acf_the_content', array( $GLOBALS['wp_embed'], 'run_shortcode' ), 8 ); |
51
|
|
|
add_filter( 'acf_the_content', array( $GLOBALS['wp_embed'], 'autoembed' ), 8 ); |
52
|
|
|
|
53
|
|
|
} |
54
|
|
|
|
55
|
|
|
add_filter( 'acf_the_content', 'capital_P_dangit', 11 ); |
56
|
|
|
add_filter( 'acf_the_content', 'wptexturize' ); |
57
|
|
|
add_filter( 'acf_the_content', 'convert_smilies' ); |
58
|
|
|
add_filter( 'acf_the_content', 'convert_chars' ); // not found in WP 4.4 |
59
|
|
|
add_filter( 'acf_the_content', 'wpautop' ); |
60
|
|
|
add_filter( 'acf_the_content', 'shortcode_unautop' ); |
61
|
|
|
//add_filter( 'acf_the_content', 'prepend_attachment' ); should only be for the_content (causes double image on attachment page) |
62
|
|
|
if( function_exists('wp_make_content_images_responsive') ) { |
63
|
|
|
|
64
|
|
|
add_filter( 'acf_the_content', 'wp_make_content_images_responsive' ); // added in WP 4.4 |
65
|
|
|
|
66
|
|
|
} |
67
|
|
|
|
68
|
|
|
add_filter( 'acf_the_content', 'do_shortcode', 11); |
69
|
|
|
|
70
|
|
|
|
71
|
|
|
// actions |
72
|
|
|
add_action('acf/input/admin_footer_js', array($this, 'input_admin_footer_js')); |
73
|
|
|
|
74
|
|
|
|
75
|
|
|
// do not delete! |
76
|
|
|
parent::__construct(); |
77
|
|
|
|
78
|
|
|
} |
79
|
|
|
|
80
|
|
|
|
81
|
|
|
/* |
82
|
|
|
* get_toolbars |
83
|
|
|
* |
84
|
|
|
* This function will return an array of toolbars for the WYSIWYG field |
85
|
|
|
* |
86
|
|
|
* @type function |
87
|
|
|
* @date 18/04/2014 |
88
|
|
|
* @since 5.0.0 |
89
|
|
|
* |
90
|
|
|
* @param n/a |
91
|
|
|
* @return (array) |
92
|
|
|
*/ |
93
|
|
|
|
94
|
|
|
function get_toolbars() { |
|
|
|
|
95
|
|
|
|
96
|
|
|
// global |
97
|
|
|
global $wp_version; |
|
|
|
|
98
|
|
|
|
99
|
|
|
|
100
|
|
|
// vars |
101
|
|
|
$toolbars = array(); |
102
|
|
|
$editor_id = 'acf_content'; |
103
|
|
|
|
104
|
|
|
|
105
|
|
|
if( version_compare($wp_version, '3.9', '>=' ) ) { |
106
|
|
|
|
107
|
|
|
// Full |
108
|
|
|
$toolbars['Full'] = array( |
109
|
|
|
|
110
|
|
|
1 => apply_filters('mce_buttons', array('bold', 'italic', 'strikethrough', 'bullist', 'numlist', 'blockquote', 'hr', 'alignleft', 'aligncenter', 'alignright', 'link', 'unlink', 'wp_more', 'spellchecker', 'fullscreen', 'wp_adv' ), $editor_id), |
111
|
|
|
|
112
|
|
|
2 => apply_filters('mce_buttons_2', array( 'formatselect', 'underline', 'alignjustify', 'forecolor', 'pastetext', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help' ), $editor_id), |
113
|
|
|
|
114
|
|
|
3 => apply_filters('mce_buttons_3', array(), $editor_id), |
115
|
|
|
|
116
|
|
|
4 => apply_filters('mce_buttons_4', array(), $editor_id), |
117
|
|
|
|
118
|
|
|
); |
119
|
|
|
|
120
|
|
|
|
121
|
|
|
// Basic |
122
|
|
|
$toolbars['Basic'] = array( |
123
|
|
|
|
124
|
|
|
1 => apply_filters('teeny_mce_buttons', array('bold', 'italic', 'underline', 'blockquote', 'strikethrough', 'bullist', 'numlist', 'alignleft', 'aligncenter', 'alignright', 'undo', 'redo', 'link', 'unlink', 'fullscreen'), $editor_id), |
125
|
|
|
|
126
|
|
|
); |
127
|
|
|
|
128
|
|
|
} else { |
129
|
|
|
|
130
|
|
|
// Full |
131
|
|
|
$toolbars['Full'] = array( |
132
|
|
|
|
133
|
|
|
1 => apply_filters('mce_buttons', array('bold', 'italic', 'strikethrough', 'bullist', 'numlist', 'blockquote', 'justifyleft', 'justifycenter', 'justifyright', 'link', 'unlink', 'wp_more', 'spellchecker', 'fullscreen', 'wp_adv' ), $editor_id), |
134
|
|
|
|
135
|
|
|
2 => apply_filters('mce_buttons_2', array( 'formatselect', 'underline', 'justifyfull', 'forecolor', 'pastetext', 'pasteword', 'removeformat', 'charmap', 'outdent', 'indent', 'undo', 'redo', 'wp_help' ), $editor_id), |
136
|
|
|
|
137
|
|
|
3 => apply_filters('mce_buttons_3', array(), $editor_id), |
138
|
|
|
|
139
|
|
|
4 => apply_filters('mce_buttons_4', array(), $editor_id), |
140
|
|
|
|
141
|
|
|
); |
142
|
|
|
|
143
|
|
|
|
144
|
|
|
// Basic |
145
|
|
|
$toolbars['Basic'] = array( |
146
|
|
|
|
147
|
|
|
1 => apply_filters( 'teeny_mce_buttons', array('bold', 'italic', 'underline', 'blockquote', 'strikethrough', 'bullist', 'numlist', 'justifyleft', 'justifycenter', 'justifyright', 'undo', 'redo', 'link', 'unlink', 'fullscreen'), $editor_id ), |
148
|
|
|
|
149
|
|
|
); |
150
|
|
|
|
151
|
|
|
} |
152
|
|
|
|
153
|
|
|
|
154
|
|
|
// Filter for 3rd party |
155
|
|
|
$toolbars = apply_filters( 'acf/fields/wysiwyg/toolbars', $toolbars ); |
156
|
|
|
|
157
|
|
|
|
158
|
|
|
// return |
159
|
|
|
return $toolbars; |
160
|
|
|
|
161
|
|
|
} |
162
|
|
|
|
163
|
|
|
|
164
|
|
|
/* |
165
|
|
|
* input_admin_footer_js |
166
|
|
|
* |
167
|
|
|
* description |
168
|
|
|
* |
169
|
|
|
* @type function |
170
|
|
|
* @date 6/03/2014 |
171
|
|
|
* @since 5.0.0 |
172
|
|
|
* |
173
|
|
|
* @param $post_id (int) |
174
|
|
|
* @return $post_id (int) |
175
|
|
|
*/ |
|
|
|
|
176
|
|
|
|
177
|
|
|
function input_admin_footer_js() { |
|
|
|
|
178
|
|
|
|
179
|
|
|
// vars |
180
|
|
|
$json = array(); |
181
|
|
|
$toolbars = $this->get_toolbars(); |
182
|
|
|
|
183
|
|
|
|
184
|
|
|
// bail ealry if no toolbars |
185
|
|
|
if( empty($toolbars) ) { |
186
|
|
|
|
187
|
|
|
return; |
188
|
|
|
|
189
|
|
|
} |
190
|
|
|
|
191
|
|
|
|
192
|
|
|
// loop through toolbars |
193
|
|
|
foreach( $toolbars as $label => $rows ) { |
194
|
|
|
|
195
|
|
|
// vars |
196
|
|
|
$label = sanitize_title( $label ); |
197
|
|
|
$label = str_replace('-', '_', $label); |
198
|
|
|
|
199
|
|
|
|
200
|
|
|
// append to $json |
201
|
|
|
$json[ $label ] = array(); |
202
|
|
|
|
203
|
|
|
|
204
|
|
|
// convert to strings |
205
|
|
|
if( !empty($rows) ) { |
206
|
|
|
|
207
|
|
|
foreach( $rows as $i => $row ) { |
208
|
|
|
|
209
|
|
|
$json[ $label ][ $i ] = implode(',', $row); |
210
|
|
|
|
211
|
|
|
} |
212
|
|
|
|
213
|
|
|
} |
214
|
|
|
|
215
|
|
|
} |
216
|
|
|
|
217
|
|
|
|
218
|
|
|
?>acf.fields.wysiwyg.toolbars = <?php echo json_encode($json); ?>; |
219
|
|
|
<?php |
220
|
|
|
|
221
|
|
|
} |
222
|
|
|
|
223
|
|
|
|
224
|
|
|
/* |
225
|
|
|
* render_field() |
226
|
|
|
* |
227
|
|
|
* Create the HTML interface for your field |
228
|
|
|
* |
229
|
|
|
* @param $field - an array holding all the field's data |
230
|
|
|
* |
231
|
|
|
* @type action |
232
|
|
|
* @since 3.6 |
233
|
|
|
* @date 23/01/13 |
234
|
|
|
*/ |
235
|
|
|
|
236
|
|
|
function render_field( $field ) { |
|
|
|
|
237
|
|
|
|
238
|
|
|
// global |
239
|
|
|
global $wp_version; |
|
|
|
|
240
|
|
|
|
241
|
|
|
|
242
|
|
|
// enqueue |
243
|
|
|
acf_enqueue_uploader(); |
244
|
|
|
|
245
|
|
|
|
246
|
|
|
// vars |
247
|
|
|
$id = uniqid('acf-editor-'); |
248
|
|
|
$default_editor = 'html'; |
249
|
|
|
$show_tabs = true; |
250
|
|
|
$button = ''; |
|
|
|
|
251
|
|
|
|
252
|
|
|
|
253
|
|
|
// get height |
254
|
|
|
$height = acf_get_user_setting('wysiwyg_height', 300); |
|
|
|
|
255
|
|
|
$height = max( $height, 300 ); // minimum height is 300 |
256
|
|
|
|
257
|
|
|
|
258
|
|
|
// detect mode |
259
|
|
|
if( $field['tabs'] == 'visual' ) { |
260
|
|
|
|
261
|
|
|
// case: visual tab only |
262
|
|
|
$default_editor = 'tinymce'; |
263
|
|
|
$show_tabs = false; |
264
|
|
|
|
265
|
|
|
} elseif( $field['tabs'] == 'text' ) { |
266
|
|
|
|
267
|
|
|
// case: text tab only |
268
|
|
|
$show_tabs = false; |
269
|
|
|
|
270
|
|
|
} elseif( wp_default_editor() == 'tinymce' ) { |
271
|
|
|
|
272
|
|
|
// case: both tabs |
273
|
|
|
$default_editor = 'tinymce'; |
274
|
|
|
|
275
|
|
|
} |
276
|
|
|
|
277
|
|
|
|
278
|
|
|
// must be logged in tp upload |
279
|
|
|
if( !current_user_can('upload_files') ) { |
280
|
|
|
|
281
|
|
|
$field['media_upload'] = 0; |
282
|
|
|
|
283
|
|
|
} |
284
|
|
|
|
285
|
|
|
|
286
|
|
|
// mode |
287
|
|
|
$switch_class = ($default_editor === 'html') ? 'html-active' : 'tmce-active'; |
288
|
|
|
|
289
|
|
|
|
290
|
|
|
// filter value for editor |
291
|
|
|
remove_filter( 'acf_the_editor_content', 'format_for_editor', 10, 2 ); |
292
|
|
|
remove_filter( 'acf_the_editor_content', 'wp_htmledit_pre', 10, 1 ); |
293
|
|
|
remove_filter( 'acf_the_editor_content', 'wp_richedit_pre', 10, 1 ); |
294
|
|
|
|
295
|
|
|
|
296
|
|
|
// WP 4.3 |
297
|
|
|
if( version_compare($wp_version, '4.3', '>=' ) ) { |
298
|
|
|
|
299
|
|
|
add_filter( 'acf_the_editor_content', 'format_for_editor', 10, 2 ); |
300
|
|
|
|
301
|
|
|
$button = 'data-wp-editor-id="' . $id . '"'; |
302
|
|
|
|
303
|
|
|
// WP < 4.3 |
304
|
|
|
} else { |
305
|
|
|
|
306
|
|
|
$function = ($default_editor === 'html') ? 'wp_htmledit_pre' : 'wp_richedit_pre'; |
307
|
|
|
|
308
|
|
|
add_filter('acf_the_editor_content', $function, 10, 1); |
309
|
|
|
|
310
|
|
|
$button = 'onclick="switchEditors.switchto(this);"'; |
311
|
|
|
|
312
|
|
|
} |
313
|
|
|
|
314
|
|
|
|
315
|
|
|
// filter |
316
|
|
|
$field['value'] = apply_filters( 'acf_the_editor_content', $field['value'], $default_editor ); |
317
|
|
|
|
318
|
|
|
?> |
319
|
|
|
<div id="wp-<?php echo $id; ?>-wrap" class="acf-editor-wrap wp-core-ui wp-editor-wrap <?php echo $switch_class; ?>" data-toolbar="<?php echo $field['toolbar']; ?>" data-upload="<?php echo $field['media_upload']; ?>"> |
320
|
|
|
<div id="wp-<?php echo $id; ?>-editor-tools" class="wp-editor-tools hide-if-no-js"> |
321
|
|
|
<?php if( $field['media_upload'] ): ?> |
322
|
|
|
<div id="wp-<?php echo $id; ?>-media-buttons" class="wp-media-buttons"> |
323
|
|
|
<?php do_action( 'media_buttons', $id ); ?> |
324
|
|
|
</div> |
325
|
|
|
<?php endif; ?> |
326
|
|
|
<?php if( user_can_richedit() && $show_tabs ): ?> |
327
|
|
|
<div class="wp-editor-tabs"> |
328
|
|
|
<button id="<?php echo $id; ?>-tmce" class="wp-switch-editor switch-tmce" <?php echo $button; ?> type="button"><?php echo __('Visual', 'acf'); ?></button> |
329
|
|
|
<button id="<?php echo $id; ?>-html" class="wp-switch-editor switch-html" <?php echo $button; ?> type="button"><?php echo _x( 'Text', 'Name for the Text editor tab (formerly HTML)', 'acf' ); ?></button> |
330
|
|
|
</div> |
331
|
|
|
<?php endif; ?> |
332
|
|
|
</div> |
333
|
|
|
<div id="wp-<?php echo $id; ?>-editor-container" class="wp-editor-container"> |
334
|
|
|
<textarea id="<?php echo $id; ?>" class="wp-editor-area" name="<?php echo $field['name']; ?>" <?php if($height): ?>style="height:<?php echo $height; ?>px;"<?php endif; ?>><?php echo $field['value']; ?></textarea> |
335
|
|
|
</div> |
336
|
|
|
</div> |
337
|
|
|
<?php |
338
|
|
|
|
339
|
|
|
} |
340
|
|
|
|
341
|
|
|
|
342
|
|
|
/* |
343
|
|
|
* render_field_settings() |
344
|
|
|
* |
345
|
|
|
* Create extra options for your field. This is rendered when editing a field. |
346
|
|
|
* The value of $field['name'] can be used (like bellow) to save extra data to the $field |
347
|
|
|
* |
348
|
|
|
* @type action |
349
|
|
|
* @since 3.6 |
350
|
|
|
* @date 23/01/13 |
351
|
|
|
* |
352
|
|
|
* @param $field - an array holding all the field's data |
353
|
|
|
*/ |
354
|
|
|
|
355
|
|
|
function render_field_settings( $field ) { |
|
|
|
|
356
|
|
|
|
357
|
|
|
// vars |
358
|
|
|
$toolbars = $this->get_toolbars(); |
359
|
|
|
$choices = array(); |
360
|
|
|
|
361
|
|
View Code Duplication |
if( !empty($toolbars) ) { |
|
|
|
|
362
|
|
|
|
363
|
|
|
foreach( $toolbars as $k => $v ) { |
364
|
|
|
|
365
|
|
|
$label = $k; |
366
|
|
|
$name = sanitize_title( $label ); |
367
|
|
|
$name = str_replace('-', '_', $name); |
368
|
|
|
|
369
|
|
|
$choices[ $name ] = $label; |
370
|
|
|
} |
371
|
|
|
} |
372
|
|
|
|
373
|
|
|
|
374
|
|
|
// default_value |
375
|
|
|
acf_render_field_setting( $field, array( |
376
|
|
|
'label' => __('Default Value','acf'), |
377
|
|
|
'instructions' => __('Appears when creating a new post','acf'), |
378
|
|
|
'type' => 'textarea', |
379
|
|
|
'name' => 'default_value', |
380
|
|
|
)); |
381
|
|
|
|
382
|
|
|
|
383
|
|
|
// tabs |
384
|
|
|
acf_render_field_setting( $field, array( |
385
|
|
|
'label' => __('Tabs','acf'), |
386
|
|
|
'instructions' => '', |
387
|
|
|
'type' => 'select', |
388
|
|
|
'name' => 'tabs', |
389
|
|
|
'choices' => array( |
390
|
|
|
'all' => __("Visual & Text",'acf'), |
391
|
|
|
'visual' => __("Visual Only",'acf'), |
392
|
|
|
'text' => __("Text Only",'acf'), |
393
|
|
|
) |
394
|
|
|
)); |
395
|
|
|
|
396
|
|
|
|
397
|
|
|
// toolbar |
398
|
|
|
acf_render_field_setting( $field, array( |
399
|
|
|
'label' => __('Toolbar','acf'), |
400
|
|
|
'instructions' => '', |
401
|
|
|
'type' => 'select', |
402
|
|
|
'name' => 'toolbar', |
403
|
|
|
'choices' => $choices |
404
|
|
|
)); |
405
|
|
|
|
406
|
|
|
|
407
|
|
|
// media_upload |
408
|
|
|
acf_render_field_setting( $field, array( |
409
|
|
|
'label' => __('Show Media Upload Buttons?','acf'), |
410
|
|
|
'instructions' => '', |
411
|
|
|
'type' => 'radio', |
412
|
|
|
'name' => 'media_upload', |
413
|
|
|
'layout' => 'horizontal', |
414
|
|
|
'choices' => array( |
415
|
|
|
1 => __("Yes",'acf'), |
416
|
|
|
0 => __("No",'acf'), |
417
|
|
|
) |
418
|
|
|
)); |
419
|
|
|
|
420
|
|
|
} |
421
|
|
|
|
422
|
|
|
|
423
|
|
|
/* |
424
|
|
|
* format_value() |
425
|
|
|
* |
426
|
|
|
* This filter is appied to the $value after it is loaded from the db and before it is returned to the template |
427
|
|
|
* |
428
|
|
|
* @type filter |
429
|
|
|
* @since 3.6 |
430
|
|
|
* @date 23/01/13 |
431
|
|
|
* |
432
|
|
|
* @param $value (mixed) the value which was loaded from the database |
433
|
|
|
* @param $post_id (mixed) the $post_id from which the value was loaded |
434
|
|
|
* @param $field (array) the field array holding all the field options |
435
|
|
|
* |
436
|
|
|
* @return $value (mixed) the modified value |
437
|
|
|
*/ |
|
|
|
|
438
|
|
|
|
439
|
|
|
function format_value( $value, $post_id, $field ) { |
|
|
|
|
440
|
|
|
|
441
|
|
|
// bail early if no value |
442
|
|
|
if( empty($value) ) { |
443
|
|
|
|
444
|
|
|
return $value; |
445
|
|
|
|
446
|
|
|
} |
447
|
|
|
|
448
|
|
|
|
449
|
|
|
// apply filters |
450
|
|
|
$value = apply_filters( 'acf_the_content', $value ); |
451
|
|
|
|
452
|
|
|
|
453
|
|
|
// follow the_content function in /wp-includes/post-template.php |
454
|
|
|
$value = str_replace(']]>', ']]>', $value); |
455
|
|
|
|
456
|
|
|
|
457
|
|
|
return $value; |
458
|
|
|
} |
459
|
|
|
|
460
|
|
|
} |
461
|
|
|
|
462
|
|
|
new acf_field_wysiwyg(); |
463
|
|
|
|
464
|
|
|
endif; |
465
|
|
|
|
466
|
|
|
?> |
467
|
|
|
|
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.