-
-
Notifications
You must be signed in to change notification settings - Fork 43
/
admin.php
1230 lines (945 loc) · 40.9 KB
/
admin.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<?php
/**
* WP Document Revisions Admin Functionality
*
* @author Benjamin J. Balter <ben@balter.com>
* @package WP Document Revisions
*/
class Document_Revisions_Admin {
static $parent;
static $instance;
/**
* Register's admin hooks
* Note: we are at auth_redirect, first possible hook is admin_menu
* @since 0.5
* @param unknown $instance (optional, reference)
*/
function __construct( &$instance = null) {
self::$instance = &$this;
//create or store parent instance
if ( $instance === null )
self::$parent = new Document_Revisions;
else
self::$parent = &$instance;
//help and messages
add_filter( 'post_updated_messages', array(&$this, 'update_messages') );
add_action( 'contextual_help', array(&$this, 'add_help_text'), 10, 3 ); //pre-3.3
add_action( 'admin_head', array(&$this, 'add_help_tab') ); //3.3+
//edit document screen
add_action( 'admin_head', array( &$this, 'make_private' ) );
add_filter( 'media_meta', array( &$this, 'media_meta_hack'), 10, 1);
add_filter( 'media_upload_form_url', array( &$this, 'post_upload_handler' ) );
add_action( 'save_post', array( &$this, 'workflow_state_save' ) );
add_action( 'admin_init', array( &$this, 'enqueue_edit_scripts' ) );
add_action( '_wp_put_post_revision', array( &$this, 'revision_filter'), 10, 1 );
add_filter( 'default_hidden_meta_boxes', array( &$this, 'hide_postcustom_metabox'), 10, 2 );
add_action( 'admin_footer', array( &$this, 'bind_upload_cb' ) );
add_action( 'admin_head', array( &$this, 'hide_upload_header' ) );
//document list
add_filter( 'manage_edit-document_columns', array( &$this, 'rename_author_column' ) );
add_filter( 'manage_edit-document_columns', array( &$this, 'add_workflow_state_column' ) );
add_action( 'manage_document_posts_custom_column', array( &$this, 'workflow_state_column_cb' ), 10, 2 );
add_filter( 'manage_edit-document_columns', array( &$this, 'add_currently_editing_column' ), 20 );
add_action( 'manage_document_posts_custom_column', array( &$this, 'currently_editing_column_cb' ), 10, 2 );
//settings
add_action( 'admin_init', array( &$this, 'settings_fields') );
add_action( 'update_wpmu_options', array( &$this, 'network_upload_location_save' ) );
add_action( 'update_wpmu_options', array( &$this, 'network_slug_save' ) );
add_action( 'wpmu_options', array( &$this, 'network_settings_cb' ) );
add_action( 'network_admin_notices', array( &$this, 'network_settings_errors' ) );
add_filter( 'wp_redirect', array( &$this, 'network_settings_redirect' ) );
//profile
add_action( 'show_user_profile', array( $this, 'rss_key_display' ) );
add_action( 'personal_options_update', array( &$this, 'profile_update_cb' ) );
add_action( 'edit_user_profile_update', array( &$this, 'profile_update_cb' ) );
//Queue up JS
add_action( 'admin_init', array( &$this, 'enqueue_js' ) );
//media filters
add_action( 'admin_init', array( &$this, 'filter_from_media' ) );
//cleanup
add_action( 'delete_post', array( &$this, 'delete_attachments_with_document'), 10, 1 );
//edit flow support
add_action( 'admin_init', array( &$this, 'edit_flow_admin_support' ), 20 );
//admin css
add_action( 'admin_head', array( &$this, 'admin_css') );
}
/**
* Provides support to call functions of the parent class natively
* @since 1.0
* @param function $function the function to call
* @param array $args the arguments to pass to the function
* @returns mixed the result of the function
*/
function __call( $function, $args ) {
if ( method_exists( self::$parent, $function ) ) {
return call_user_func_array( array( &self::$parent, $function ), $args );
} else {
//function does not exist, provide error info
$backtrace = debug_backtrace();
trigger_error( 'Call to undefined method ' . $function . ' on line ' . $backtrace[1][line] . ' of ' . $backtrace[1][file], E_USER_ERROR );
die();
}
}
/**
* Provides support to call properties of the parent class natively
* @since 1.0
* @param string $name the property to fetch
* @returns mixed the property's value
*/
function __get( $name ) {
return Document_Revisions::$$name;
}
/**
* Registers update messages
* @since 0.5
* @param array $messages messages array
* @returns array messages array with doc. messages
*/
function update_messages( $messages ) {
global $post, $post_ID;
$messages['document'] = array(
1 => sprintf( __( 'Document updated. <a href="%s">Download document</a>', 'wp-document-revisions' ), esc_url( get_permalink($post_ID) ) ),
2 => __( 'Custom field updated.', 'wp-document-revisions' ),
3 => __( 'Custom field deleted.', 'wp-document-revisions' ),
4 => __( 'Document updated.', 'wp-document-revisions' ),
5 => isset($_GET['revision']) ? sprintf( __( 'Document restored to revision from %s', 'wp-document-revisions' ), wp_post_revision_title( (int) $_GET['revision'], false ) ) : false,
6 => sprintf( __( 'Document published. <a href="%s">Download document</a>', 'wp-document-revisions' ), esc_url( get_permalink($post_ID) ) ),
7 => __( 'Document saved.', 'wp-document-revisions' ),
8 => sprintf( __( 'Document submitted. <a target="_blank" href="%s">Download document</a>', 'wp-document-revisions' ), esc_url( add_query_arg( 'preview', 'true', get_permalink( $post_ID ) ) ) ),
9 => sprintf( __( 'Document scheduled for: <strong>%1$s</strong>. <a target="_blank" href="%2$s">Preview document</a>', 'wp-document-revisions' ), date_i18n( sprintf( _x( '%1$s @ %2$s', '%1$s: date; %2$s: time', 'wp-document-revision' ), get_option( 'date_format' ), get_option( 'time_format' ) ), strtotime( $post->post_date ) ), esc_url( get_permalink( $post_ID ) ) ),
10 => sprintf( __( 'Document draft updated. <a target="_blank" href="%s">Download document</a>', 'wp-document-revisions' ), esc_url( add_query_arg( 'preview', 'true', get_permalink( $post_ID ) ) ) ),
);
return $messages;
}
/**
* Adds help tabs to 3.3+ help tab API
* @since 1.1
* @uses get_help_text()
* @return unknown
*/
function add_help_tab( ) {
$screen = get_current_screen();
//the class WP_Screen won't exist pre-3.3
if ( !class_exists( 'WP_Screen' ) || !$screen || $screen->post_type != 'document' )
return $screen;
$help = $this->get_help_text( );
//loop through each tab in the help array and add
foreach ( $help as $title => $content ) {
$screen->add_help_tab( array(
'title' => $title,
'id' => str_replace( ' ', '_', $title ),
'content' => $content,
) );
}
}
/**
* Helper function to provide help text as either an array or as a string
* @since 1.1
* @param object $screen (optional) the current screen
* @param bool $return_array (optional) whether to return as an array or string
* @returns array|string the help text
*/
function get_help_text( $screen = null, $return_array = true ) {
if ( $screen == null )
$screen = get_current_screen();
//parent key is the id of the current screen
//child key is the title of the tab
//value is the help text (as HTML)
$help = array(
'document' => array(
__( 'Basic Usage', 'wp-document-revisions' ) =>
'<p>' . __( 'This screen allows users to collaboratively edit documents and track their revision history. To begin, enter a title for the document, click <code>Upload New Version</code> and select the file from your computer.', 'wp-document-revisions' ) . '</p>' .
'<p>' . __( 'Once successfully uploaded, you can enter a revision log message, assign the document an author, and describe its current workflow state.', 'wp-document-revisions' ) . '</p>' .
'<p>' . __( 'When done, simply click <code>Update</code> to save your changes', 'wp-document-revisions' ) . '</p>',
__( 'Revision Log', 'wp-document-revisions' ) =>
'<p>' . __( 'The revision log provides a short summary of the changes reflected in a particular revision. Used widely in the open-source community, it provides a comprehensive history of the document at a glance.', 'wp-document-revisions' ) . '</p>' .
'<p>' . __( 'You can download and view previous versions of the document by clicking the timestamp in the revision log. You can also restore revisions by clicking the <code>restore</code> button beside the revision.', 'wp-document-revisions' ) . '</p>',
__( 'Workflow State', 'wp-document-revisions' ) =>
'<p>' . __( 'The workflow state field can be used to help team members understand at what stage a document sits within a particular organization"s workflow. The field is optional, and can be customized or queried by clicking <code>Workflow States</code> on the left-hand side.', 'wp-document-revisions' ) . '</p>',
__( 'Publishing Documents', 'wp-document-revisions' ) =>
'<p>' . __( 'By default, uploaded documents are only accessible to logged in users. Documents can be published, thus making them accessible to the world, by toggling their visibility in the "Publish" box in the top right corner. Any document marked as published will be accessible to anyone with the proper URL.', 'wp-document-revisions' ) . '</p>',
),
'edit-document' => array(
__( 'Documents', 'wp-document-revisions' ) =>
'<p>' . __( 'Below is a list of all documents to which you have access. Click the document title to edit the document or download the latest version.', 'wp-document-revisions' ) . '</p>' .
'<p>' . __( 'To add a new document, click <strong>Add Document</strong> on the left-hand side.', 'wp-document-revisions' ) . '</p>' .
'<p>' . __( 'To view all documents at a particular workflow state, click <strong>Workflow States</strong> in the menu on the left.', 'wp-document-revisions' ) . '</p>',
),
);
//if we don't have any help text for this screen, just kick
if ( !isset( $help[ $screen->id] ) )
return ( $return_array ) ? array() : '';
if ( $return_array )
return apply_filters( 'document_help_array', $help[ $screen->id], $screen );
//convert array into string for pre-3.3 compatability
$output = '';
foreach ( $help[ $screen->id] as $label => $text )
$output .= "<h4>{$label}</h4>{$text}";
return apply_filters( 'document_help', $output, $screen );
}
/**
* Registers help text with WP for pre-3.3 versions
* @uses get_hel_text()
* @since 0.5
* @param unknown $contextual_help
* @param unknown $screen_id
* @param unknown $screen
* @return unknown
*/
function add_help_text( $contextual_help, $screen_id, $screen ) {
if ( isset( $screen->post_type) && $screen->post_type != 'document' )
return $contextual_help;
$contextual_help = $this->get_help_text( $screen, false );
return apply_filters( 'document_help', $contextual_help );
}
/**
* Callback to manage metaboxes on edit page
* @ since 0.5
*/
function meta_cb() {
global $post;
//remove unused meta boxes
remove_meta_box( 'revisionsdiv', 'document', 'normal' );
remove_meta_box( 'postexcerpt', 'document', 'normal' );
remove_meta_box( 'tagsdiv-workflow_state', 'document', 'side' );
//add our meta boxes
add_meta_box( 'revision-summary', __('Revision Summary', 'wp-document-revisions'), array(&$this, 'revision_summary_cb'), 'document', 'normal', 'default' );
add_meta_box( 'document', __('Document', 'wp-document-revisions'), array(&$this, 'document_metabox'), 'document', 'normal', 'high' );
if ( $post->post_content != '' )
add_meta_box('revision-log', 'Revision Log', array( &$this, 'revision_metabox'), 'document', 'normal', 'low' );
if ( taxonomy_exists( 'workflow_state' ) )
add_meta_box( 'workflow-state', __('Workflow State', 'wp-document-revisions'), array( &$this, 'workflow_state_metabox_cb'), 'document', 'side', 'default' );
//move author div to make room for ours
remove_meta_box( 'authordiv', 'document', 'normal' );
//only add author div if user can give someone else ownership
if ( current_user_can( 'edit_others_documents' ) )
add_meta_box( 'authordiv', __('Owner', 'wp-document-revisions'), array( &$this, 'post_author_meta_box' ), 'document', 'side', 'low' );
//lock notice
add_action( 'admin_notices', array( &$this, 'lock_notice' ) );
do_action( 'document_edit' );
}
/**
* Forces postcustom metabox to be hidden by default, despite the fact that the CPT creates it
* @since 1.0
* @param array $hidden the default hidden metaboxes
* @param array $screen the current screen
* @returns array defaults with postcustom
*/
function hide_postcustom_metabox( $hidden, $screen ) {
if ( !$screen->id == 'document' )
return $hidden;
$hidden[] = 'postcustom';
return $hidden;
}
/**
* Inject CSS into admin head
* @since 0.5
*/
function admin_css() {
global $post; ?>
<style>
.icon32-posts-document{background-position: 0 0 !important;
background-image:url('<?php echo plugins_url("icon32.png",dirname(__FILE__));?>') !important;}
@media only screen and (-webkit-min-device-pixel-ratio: 1.5),
only screen and (-o-min-device-pixel-ratio: 3/2),
only screen and (min-moz-device-pixel-ratio: 1.5),
only screen and (min-device-pixel-ratio: 1.5) {
.icon32-posts-document{
background-image:url('<?php echo plugins_url("icon64.png",dirname(__FILE__));?>') !important;
background-size:32px 32px !important;}
}
#postdiv {display:none;}
#lock-notice {background-color: #D4E8BA; border-color: #92D43B; }
#document-revisions {width: 100%; text-align: left;}
#document-revisions td {padding: 5px 0 0 0;}
#workflow-state select {margin-left: 25px; width: 150px;}
#authordiv select {width: 150px;}
#lock_override {float:right; text-align: right; margin-top: 10px; padding-bottom: 5px; }
#revision-summary {display:none;}
#autosave-alert {display:none;}
<?php if ( $this->get_document_lock( $post ) ) { ?>
#publish, .add_media, #lock-notice {display: none;}
<?php } ?>
<?php do_action('document_admin_css'); ?>
</style>
<?php }
/**
* Hide header (gallery, URL, library, etc.) links from media-upload
* No real use case for a revision being an already uploaded file,
* and javascript not compatible for that usecase as written
* @since 1.2.4
*/
function hide_upload_header() {
if ( get_current_screen()->id != 'media-upload' )
return;
if ( !$this->verify_post_type( $_GET['post_id'] ) )
return;
?>
<style>
#media-upload-header {display:none;}
</style>
<?php
}
/**
* Metabox to provide common document functions
* @since 0.5
* @param object $post the post object
*/
function document_metabox($post) {?>
<input type="hidden" id="content" name="content" value="<?php echo esc_attr( $post->post_content) ; ?>" />
<?php
if ( $lock_holder = $this->get_document_lock( $post ) ) { ?>
<div id="lock_override" class="hide-if-no-js"><?php printf( __('%s has prevented other users from making changes.', 'wp-document-revisions'), $lock_holder ); ?>
<?php if ( current_user_can( 'override_document_lock' ) ) { ?>
<?php _e('<br />If you believe this is in error you can <a href="#" id="override_link">override the lock</a>, but their changes will be lost.', 'wp-document-revisions'); ?>
<?php } ?>
</div>
<?php } ?>
<div id="lock_override"><a href='media-upload.php?post_id=<?php echo $post->ID; ?>&TB_iframe=1' id='content-add_media' class='thickbox add_media button' title='Upload Document' onclick='return false;' ><?php _e( 'Upload New Version', 'wp-document-revisions' ); ?></a></div>
<?php
$latest_version = $this->get_latest_revision( $post->ID );
if ( $latest_version ) {
?>
<p><strong><?php _e( 'Latest Version of the Document', 'wp-document-revisions' ); ?>:</strong>
<strong><a href="<?php echo get_permalink( $post->ID ); ?>" target="_BLANK"><?php _e( 'Download', 'wp-document-revisions' ); ?></a></strong><br />
<em><?php printf( __( 'Checked in <abbr class="timestamp" title="%1$s" id="%2$s">%3$s</abbr> ago by %4$s', 'wp-document-revisions' ), $latest_version->post_date, strtotime( $latest_version->post_date ), human_time_diff( (int) get_post_modified_time( 'U', null, $post->ID ), current_time( 'timestamp' ) ), get_the_author_meta( 'display_name', $latest_version->post_author ) ) ?></a></em>
</p>
<?php } //end if latest version ?>
<div class="clear"></div>
<?php }
/**
* Custom excerpt metabox CB
* @since 0.5
*/
function revision_summary_cb() { ?>
<label class="screen-reader-text" for="excerpt"><?php _e('Revision Summary'); ?></label>
<textarea rows="1" cols="40" name="excerpt" tabindex="6" id="excerpt"></textarea>
<p><?php _e( 'Revision summaries are optional notes to store along with this revision that allow other users to quickly and easily see what changes you made without needing to open the actual file.', 'wp-document-revisions' ); ?></a></p>
<?php }
/**
* Creates revision log metabox
* @since 0.5
* @param object $post the post object
*/
function revision_metabox( $post ) {
$can_edit_post = current_user_can( 'edit_post', $post->ID );
$revisions = $this->get_revisions( $post->ID );
?>
<table id="document-revisions">
<tr class="header">
<th><?php _e( 'Modified', 'wp-document-revisions'); ?></th>
<th><?php _e( 'User', 'wp-document-revisions' ); ?></th>
<th style="width:50%"><?php _e( 'Summary', 'wp-document-revisions' ); ?></th>
<?php if ( $can_edit_post ) { ?><th><?php _e( 'Actions', 'wp-document-revisions' ); ?></th><?php } ?>
</tr>
<?php
foreach ( $revisions as $revision ) {
if ( !current_user_can( 'read_post', $revision->ID ) || wp_is_post_autosave( $revision ) )
continue;
?>
<tr>
<td><a href="<?php echo get_permalink( $revision->ID ); ?>" title="<?php echo $revision->post_date; ?>" class="timestamp" id="<?php echo strtotime( $revision->post_date ); ?>"><?php echo human_time_diff( strtotime( $revision->post_date ), current_time('timestamp') ); ?></a></td>
<td><?php echo get_the_author_meta( 'display_name', $revision->post_author ); ?></td>
<td><?php echo $revision->post_excerpt; ?></td>
<?php if ( $can_edit_post ) { ?><td>
<?php if ( $post->ID != $revision->ID ) { ?>
<a href="<?php echo wp_nonce_url( add_query_arg( array( 'revision' => $revision->ID, 'action' => 'restore' ), 'revision.php' ), "restore-post_$post->ID|$revision->ID" ); ?>" class="revision"><?php _e( 'Restore', 'wp-document-revisions'); ?></a>
<?php } ?>
</td>
<?php } ?>
</tr>
<?php
}
?>
</table>
<?php $key = $this->get_feed_key(); ?>
<p style="padding-top: 10px;";><a href="<?php echo add_query_arg( 'key', $key, get_permalink( $post->ID ) . '/feed/' ); ?>"><?php _e( 'RSS Feed', 'wp-document-revisions' ); ?></a></p>
<?php
}
/**
* Forces autosave to load
* By default, if there's a lock on the post, auto save isn't loaded; we want it in case lock is overridden
* @since 0.5
*/
function enqueue_edit_scripts() {
if ( !$this->verify_post_type() )
return;
wp_enqueue_script( 'autosave' );
add_thickbox();
wp_enqueue_script('media-upload');
}
/**
* Registers the document settings
* @since 0.5
*/
function settings_fields() {
register_setting( 'media', 'document_upload_directory', array( &$this, 'sanitize_upload_dir') );
register_setting( 'media', 'document_slug', array( &$this, 'sanitize_document_slug') );
add_settings_field( 'document_upload_directory', 'Document Upload Directory', array( &$this, 'upload_location_cb' ), 'media', 'uploads' );
add_settings_field( 'document_slug', __( 'Document Slug', 'wp-document-revisions' ), array( &$this, 'document_slug_cb' ), 'media', 'uploads' );
}
/**
* Verifies that upload directory is a valid directory before updating the setting
* Attempts to create the directory if it does not exist
* @since 1.0
* @param string $dir path to the new directory
* @returns bool|string false on fail, path to new dir on sucess
*/
function sanitize_upload_dir( $dir ) {
//empty string passed
if ( $dir == '' )
return $this->document_upload_dir();
//if the path is not absolute, assume it's relative to ABSPATH
if ( substr( $dir, 0, 1) != '/' )
$dir = ABSPATH . $dir;
//dir didn't change
if ( $dir == $this->document_upload_dir() )
return $dir;
//dir changed, throw warning
$msg = __( 'Document upload directory changed, but existing uploads may need to be moved to the new folder to ensure they remain accessible.', 'wp-document-revisions' );
//don't fire more than once
if ( sizeof( get_settings_errors( 'document_upload_directory' ) ) == 0 )
add_settings_error( 'document_upload_directory', 'document-upload-dir-change', $msg, 'updated' );
//trim and return
return rtrim($dir, "/");
}
/**
* Sanitize slug prior to saving
* @param string $slug new slug
* @return string sanitized slug
*/
function sanitize_document_slug( $slug ) {
$slug = sanitize_title( $slug, 'documents' );
//unchanged
if ( $slug == $this->document_slug() )
return $slug;
//new slug isn't yet stored
// but queue up a rewrite rule flush to ensure slug takes effect on next request
add_action( 'shutdown', 'flush_rewrite_rules' );
$msg = __( 'Document slug changed, but some previously published URLs may now be broken.', 'wp-document-revisions' );
add_settings_error( 'document_slug', 'document-slug-change', $msg, 'updated' );
return $slug;
}
/**
* Adds upload directory and document slug options to network admin page
* @since 1.0
*/
function network_settings_cb() { ?>
<h3><?php _e( 'Document Settings', 'wp-document-revisions'); ?></h3>
<table id="document_settings" class="form-table">
<tr valign="top">
<th scope="row"><?php _e('Document Upload Directory', 'wp-document-revisions'); ?></th>
<td>
<?php $this->upload_location_cb(); ?>
<?php wp_nonce_field( 'network_document_upload_location', 'document_upload_location_nonce' ); ?>
</td>
</tr>
<tr>
<th scope="row"><?php _e('Document Slug', 'wp-document-revisions'); ?></th>
<td>
<?php $this->document_slug_cb(); ?>
<?php wp_nonce_field( 'network_document_slug', 'document_slug_nonce' ); ?>
</td>
</tr>
</table>
<?php }
/**
* Callback to validate and save the network upload directory
* @since 1.0
*/
function network_upload_location_save() {
if ( !isset( $_POST['document_upload_location_nonce'] ) )
return;
//verify nonce
if ( !wp_verify_nonce( $_POST['document_upload_location_nonce'], 'network_document_upload_location' ) )
wp_die( __( 'Not authorized' ) );
//auth
if ( !current_user_can( 'manage_network_options' ) )
wp_die( __( 'Not authorized' ) );
//verify upload dir
$dir = $this->sanitize_upload_dir( $_POST['document_upload_directory'] );
//becuase there's a redirect, and there's no settings API, force settings errors into a transient
global $wp_settings_errors;
set_transient( 'settings_errors', $wp_settings_errors );
//if the dir didn't validate, kick
if ( !$dir )
return;
//save the dir
update_site_option( 'document_upload_directory', $dir );
}
/**
* Callback to validate and save slug on network settings page
*/
function network_slug_save() {
if ( !isset( $_POST['document_slug_nonce'] ) )
return;
//verify nonce
if ( !wp_verify_nonce( $_POST['document_slug_nonce'], 'network_document_slug' ) )
wp_die( __( 'Not authorized' ) );
//auth
if ( !current_user_can( 'manage_network_options' ) )
wp_die( __( 'Not authorized' ) );
//verify upload dir
$slug = $this->sanitize_document_slug( $_POST['document_slug'] );
//becuase there's a redirect, and there's no settings API, force settings errors into a transient
global $wp_settings_errors;
set_transient( 'settings_errors', $wp_settings_errors );
//if the dir didn't validate, kick
if ( !$slug )
return;
//save the dir
update_site_option( 'document_slug', $slug );
}
/**
* Adds settings errors to network settings page for document upload directory CB
* @since 1.0
*/
function network_settings_errors() {
settings_errors( 'document_upload_directory' );
settings_errors( 'document_slug' );
}
/**
* Appends the settings-updated query arg to the network admin settings redirect so that the settings API can work
* @since 1.0
* @param string $location the URL being redirected to
* @returns string the modified location
*/
function network_settings_redirect( $location ) {
//Verify redirect string from /wp-admin/network/edit.php line 164
if ( $location != add_query_arg( 'updated', 'true', network_admin_url( 'settings.php' ) ) )
return $location;
//append the settings-updated query arg and return
return add_query_arg( 'settings-updated', 'true', $location );
}
/**
* Callback to create the upload location settings field
* @since 0.5
*/
function upload_location_cb() { ?>
<input name="document_upload_directory" type="text" id="document_upload_directory" value="<?php echo esc_attr( $this->document_upload_dir() ); ?>" class="large-text code" /><br />
<span class="description"><?php _e( 'Directory in which to store uploaded documents. The default is in your <code>wp_content/uploads</code> folder (or another default uploads folder defined elsewhere), but it may be moved to a folder outside of the <code>htdocs</code> or <code>public_html</code> folder for added security.', 'wp-document-revisions' ); ?></span>
<?php if ( is_multisite() ) { ?>
<span class="description"><?php _e( 'You may optionally include the string <code>%site_id%</code> within the path to separate files by site.', 'wp-document-revisions' ); ?></span>
<?php } ?>
<?php }
/**
* Callback to create the document slug settings field
*/
function document_slug_cb() { ?>
<code><?php bloginfo( 'url' ); ?>/<input name="document_slug" type="text" id="document_slug" value="<?php echo esc_attr( $this->document_slug() ); ?>" class="medium-text" />/<?php echo date('Y'); ?>/<?php echo date('m'); ?>/<?php _e( 'example-document-title' ); ?>.txt</code>
<br /><span class="description"><?php _e( '"Slug" with which to prefix all URLs for documents (and the document archive). Default is "documents."', 'wp-document-revisions' ); ?></span>
<?php }
/**
* Callback to inject JavaScript in page after upload is complete (pre 3.3)
* @since 0.5
* @param int $id the ID of the attachment
* @return unknown
*/
function post_upload_js( $id ) {
//get the post object
$post = get_post( $id );
//get the extension from the post object to pass along to the client
$extension = $this->get_file_type( $post );
//begin output buffer so the javascript can be returned as a string, rather than output directly to the browser
ob_start();
?><script>
var attachmentID = <?php echo (int) $id; ?>;
var extension = '<?php echo $extension; ?>';
jQuery(document).ready(function($) { postDocumentUpload( extension, attachmentID ) });
</script><?php
//get contents of output buffer
$js = ob_get_contents();
//dump output buffer
ob_end_clean();
//return javascript
return $js;
}
/**
* Binds our post-upload javascript callback to the plupload event
* Note: in footer because it has to be called after handler.js is loaded and initialized
* @since 1.2.1
*/
function bind_upload_cb() {
global $pagenow;
if ( $pagenow != 'media-upload.php' )
return;
?>
<script>jQuery(document).ready(function(){bindPostDocumentUploadCB()});</script>
<?php }
/**
* Ugly, Ugly hack to sneak post-upload JS into the iframe *pre 3.3*
* If there was a hook there, I wouldn't have to do this
* @since 0.5
* @param string $meta dimensions / post meta
* @returns string meta + js to process post
*/
function media_meta_hack( $meta ) {
if ( !$this->verify_post_type( ) )
return $meta;
global $post;
$latest = $this->get_latest_attachment( $post->ID );
do_action('document_upload', $latest, $post->ID );
$meta .= $this->post_upload_js( $latest->ID );
return $meta;
}
/**
* Hook to follow file uploads to automate attaching the document to the post
* @since 0.5
* @param string $filter whatever we really should be filtering
* @returns string the same stuff they gave us, like we were never here
*/
function post_upload_handler( $filter ) {
//if we're not posting this is the initial form load, kick
if ( !$_POST )
return $filter;
if ( !$this->verify_post_type ( $_POST['post_id'] ) )
return $filter;
//get the object that is our new attachment
$latest = $this->get_latest_attachment( $_POST['post_id'] );
do_action('document_upload', $latest, $_POST['post_id'] );
echo $this->post_upload_js( $latest->ID );
//prevent hook from fireing a 2nd time
remove_filter( 'media_meta', array( &$this, 'media_meta_hack'), 10, 1);
//should probably give this back...
return $filter;
}
/**
* Retrieves the most recent file attached to a post
* @since 0.5
* @param int $post_id the parent post
* @returns object the attachment object
*/
function get_latest_attachment( $post_id ) {
$attachments = $this->get_attachments( $post_id );
return reset( $attachments );
}
/**
* Callback to display lock notice on top of edit page
* @since 0.5
*/
function lock_notice() {
global $post;
do_action( 'document_lock_notice', $post );
//if there is no page var, this is a new document, no need to warn
if ( !isset( $_GET['post'] ) )
return;
?>
<div class="error" id="lock-notice"><p><?php _e( 'You currently have this file checked out. No other user can edit this document so long as you remain on this page.', 'wp-document-revisions' ); ?></p></div>
<?php }
/**
* Callback to add RSS key field to profile page
* @since 0.5
*/
function rss_key_display( ) {
$key = $this->get_feed_key();
?>
<div class="tool-box">
<h3> <?php _e( 'Feed Privacy', 'wp-document-revisions' ); ?></h3>
<table class="form-table">
<tr id="document_revisions_feed_key">
<th><label for="feed_key"><?php _e( 'Secret Feed Key', 'wp-document-revisions' ); ?></label></th>
<td>
<input type="text" value="<?php echo esc_attr( $key ); ?>" class="regular-text" readonly="readonly" /><br />
<span class="description"><?php _e( 'To protect your privacy, you need to append a key to feeds for use in feed readers.', 'wp-document-revisions' ); ?></span><br />
<?php wp_nonce_field( 'generate-new-feed-key', '_document_revisions_nonce' ); ?>
<?php submit_button( __( 'Generate New Key', 'wp-document-revisions' ), 'secondary', 'generate-new-feed-key', false ); ?>
</td>
</tr>
</table>
<?php
}
/**
* Retrieves feed key user meta; generates if necessary
* @since 0.5
* @param int $user (optional) UserID
* @returns string the feed key
*/
function get_feed_key( $user = null ) {
$key = get_user_option( $this->meta_key, $user );
if ( !$key )
$key = $this->generate_new_feed_key();
return $key;
}
/**
* Generates, saves, and returns new feed key
* @since 0.5
* @param int $user (optional) UserID
* @returns string feed key
*/
function generate_new_feed_key( $user = null ) {
if ( !$user )
$user = get_current_user_id();
$key = wp_generate_password( $this->key_length, false, false );
update_user_option( $user, $this->meta_key, $key );
return $key;
}
/**
* Callback to handle profile updates
* @since 0.5
*/
function profile_update_cb() {
if ( isset( $_POST['generate-new-feed-key'] ) && isset( $_POST['_document_revisions_nonce'] ) && wp_verify_nonce( $_POST['_document_revisions_nonce'], 'generate-new-feed-key' ) )
$this->generate_new_feed_key();
}
/**
* Renames author column on document list to "owner"
* @since 1.0.4
* @param array $defaults the default column labels
* @returns array the modified column labels
*/
function rename_author_column( $defaults ) {
if ( isset( $defaults['author'] ) )
$defaults['author'] = __( 'Owner', 'wp-document-revisions' );
return $defaults;
}
/**
* Splices workflow state column as 2nd (3rd) column on documents page
* @since 0.5
* @param array $defaults the original columns
* @returns array our spliced columns
*/
function add_workflow_state_column( $defaults ) {
//get checkbox and title
$output = array_slice( $defaults, 0, 2 );
//splice in workflow state
$output['workflow_state'] = __( 'Workflow State', 'wp-document-revisions' );
//get the rest of the columns
$output = array_merge( $output, array_slice( $defaults, 2 ) );
//return
return $output;
}
/**
* Callback to output data for workflow state column
* @since 0.5
* @param string $column_name the name of the column being propegated
* @param int $post_id the ID of the post being displayed
*/
function workflow_state_column_cb( $column_name, $post_id ) {
//verify column
if ( $column_name != 'workflow_state' )
return;
//verify post type
if ( !$this->verify_post_type( $post_id ) )
return;
//get terms
$state = wp_get_post_terms( $post_id, 'workflow_state' );
//verify state exists
if ( sizeof( $state ) == 0)
return;
//output (no return)
echo '<a href="' . esc_url( add_query_arg( 'workflow_state', $state[0]->slug) ) . '">' . $state[0]->name . '</a>';
}
/**
* Splices in Currently Editing column to document list
* @since 1.1
* @param array $defaults the original columns
* @returns array our spliced columns
*/
function add_currently_editing_column( $defaults ) {
//get checkbox, title, and workflow state
$output = array_slice( $defaults, 0, 3 );
//splice in workflow state
$output['currently_editing'] = __( 'Currently Editing', 'wp-document-revisions' );
//get the rest of the columns
$output = array_merge( $output, array_slice( $defaults, 2 ) );
//return
return $output;
}
/**
* Callback to output data for currently editing column
* @since 1.1
* @param string $column_name the name of the column being propegated
* @param int $post_id the ID of the post being displayed
*/
function currently_editing_column_cb( $column_name, $post_id ) {
//verify column
if ( $column_name != 'currently_editing' )
return;
//verify post type
if ( !$this->verify_post_type( $post_id ) )
return;
$lock = $this->get_document_lock( $post_id );
//output will be display name, if any
if ( $lock )
echo $lock;
}
/**
* Callback to generate metabox for workflow state
* @since 0.5
* @param object $post the post object
*/
function workflow_state_metabox_cb( $post ) {
wp_nonce_field( plugin_basename( __FILE__ ), 'workflow_state_nonce' );