WordPress 4.5
[autoinstalls/wordpress.git] / wp-admin / edit-tag-form.php
1 <?php
2 /**
3  * Edit tag form for inclusion in administration panels.
4  *
5  * @package WordPress
6  * @subpackage Administration
7  */
8
9 // don't load directly
10 if ( ! defined( 'ABSPATH' ) ) {
11         die( '-1' );
12 }
13
14 // Back compat hooks
15 if ( 'category' == $taxonomy ) {
16         /**
17          * Fires before the Edit Category form.
18          *
19          * @since 2.1.0
20          * @deprecated 3.0.0 Use {$taxonomy}_pre_edit_form instead.
21          *
22          * @param object $tag Current category term object.
23          */
24         do_action( 'edit_category_form_pre', $tag );
25 } elseif ( 'link_category' == $taxonomy ) {
26         /**
27          * Fires before the Edit Link Category form.
28          *
29          * @since 2.3.0
30          * @deprecated 3.0.0 Use {$taxonomy}_pre_edit_form instead.
31          *
32          * @param object $tag Current link category term object.
33          */
34         do_action( 'edit_link_category_form_pre', $tag );
35 } else {
36         /**
37          * Fires before the Edit Tag form.
38          *
39          * @since 2.5.0
40          * @deprecated 3.0.0 Use {$taxonomy}_pre_edit_form instead.
41          *
42          * @param object $tag Current tag term object.
43          */
44         do_action( 'edit_tag_form_pre', $tag );
45 }
46
47 /**
48  * Use with caution, see http://codex.wordpress.org/Function_Reference/wp_reset_vars
49  */
50 wp_reset_vars( array( 'wp_http_referer' ) );
51
52 $wp_http_referer = remove_query_arg( array( 'action', 'message', 'tag_ID' ), $wp_http_referer );
53
54 /** Also used by Edit Tags */
55 require_once( ABSPATH . 'wp-admin/includes/edit-tag-messages.php' );
56
57 /**
58  * Fires before the Edit Term form for all taxonomies.
59  *
60  * The dynamic portion of the hook name, `$taxonomy`, refers to
61  * the taxonomy slug.
62  *
63  * @since 3.0.0
64  *
65  * @param object $tag      Current taxonomy term object.
66  * @param string $taxonomy Current $taxonomy slug.
67  */
68 do_action( "{$taxonomy}_pre_edit_form", $tag, $taxonomy ); ?>
69
70 <div class="wrap">
71 <h1><?php echo $tax->labels->edit_item; ?></h1>
72
73 <?php if ( $message ) : ?>
74 <div id="message" class="updated">
75         <p><strong><?php echo $message; ?></strong></p>
76         <?php if ( $wp_http_referer ) { ?>
77         <p><a href="<?php echo esc_url( $wp_http_referer ); ?>"><?php printf( __( '&larr; Back to %s' ), $tax->labels->name ); ?></a></p>
78         <?php } else { ?>
79         <p><a href="<?php echo esc_url( wp_get_referer() ); ?>"><?php printf( __( '&larr; Back to %s' ), $tax->labels->name ); ?></a></p>
80         <?php } ?>
81 </div>
82 <?php endif; ?>
83
84 <div id="ajax-response"></div>
85
86 <form name="edittag" id="edittag" method="post" action="edit-tags.php" class="validate"
87 <?php
88 /**
89  * Fires inside the Edit Term form tag.
90  *
91  * The dynamic portion of the hook name, `$taxonomy`, refers to
92  * the taxonomy slug.
93  *
94  * @since 3.7.0
95  */
96 do_action( "{$taxonomy}_term_edit_form_tag" );
97 ?>>
98 <input type="hidden" name="action" value="editedtag"/>
99 <input type="hidden" name="tag_ID" value="<?php echo esc_attr( $tag_ID ) ?>"/>
100 <input type="hidden" name="taxonomy" value="<?php echo esc_attr( $taxonomy ) ?>"/>
101 <?php
102 wp_original_referer_field( true, 'previous' );
103 wp_nonce_field( 'update-tag_' . $tag_ID );
104
105 /**
106  * Fires at the beginning of the Edit Term form.
107  *
108  * At this point, the required hidden fields and nonces have already been output.
109  *
110  * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
111  *
112  * @since 4.5.0
113  *
114  * @param object $tag      Current taxonomy term object.
115  * @param string $taxonomy Current $taxonomy slug.
116  */
117 do_action( "{$taxonomy}_term_edit_form_top", $tag, $taxonomy );
118 ?>
119         <table class="form-table">
120                 <tr class="form-field form-required term-name-wrap">
121                         <th scope="row"><label for="name"><?php _ex( 'Name', 'term name' ); ?></label></th>
122                         <td><input name="name" id="name" type="text" value="<?php if ( isset( $tag->name ) ) echo esc_attr($tag->name); ?>" size="40" aria-required="true" />
123                         <p class="description"><?php _e('The name is how it appears on your site.'); ?></p></td>
124                 </tr>
125 <?php if ( !global_terms_enabled() ) { ?>
126                 <tr class="form-field term-slug-wrap">
127                         <th scope="row"><label for="slug"><?php _e( 'Slug' ); ?></label></th>
128                         <?php
129                         /**
130                          * Filter the editable slug.
131                          *
132                          * Note: This is a multi-use hook in that it is leveraged both for editable
133                          * post URIs and term slugs.
134                          *
135                          * @since 2.6.0
136                          * @since 4.4.0 The `$tag` parameter was added.
137                          *
138                          * @param string         $slug The editable slug. Will be either a term slug or post URI depending
139                          *                             upon the context in which it is evaluated.
140                          * @param object|WP_Post $tag  Term or WP_Post object.
141                          */
142                         $slug = isset( $tag->slug ) ? apply_filters( 'editable_slug', $tag->slug, $tag ) : '';
143                         ?>
144                         <td><input name="slug" id="slug" type="text" value="<?php echo esc_attr( $slug ); ?>" size="40" />
145                         <p class="description"><?php _e('The &#8220;slug&#8221; is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.'); ?></p></td>
146                 </tr>
147 <?php } ?>
148 <?php if ( is_taxonomy_hierarchical($taxonomy) ) : ?>
149                 <tr class="form-field term-parent-wrap">
150                         <th scope="row"><label for="parent"><?php _ex( 'Parent', 'term parent' ); ?></label></th>
151                         <td>
152                                 <?php
153                                 $dropdown_args = array(
154                                         'hide_empty'       => 0,
155                                         'hide_if_empty'    => false,
156                                         'taxonomy'         => $taxonomy,
157                                         'name'             => 'parent',
158                                         'orderby'          => 'name',
159                                         'selected'         => $tag->parent,
160                                         'exclude_tree'     => $tag->term_id,
161                                         'hierarchical'     => true,
162                                         'show_option_none' => __( 'None' ),
163                                 );
164
165                                 /** This filter is documented in wp-admin/edit-tags.php */
166                                 $dropdown_args = apply_filters( 'taxonomy_parent_dropdown_args', $dropdown_args, $taxonomy, 'edit' );
167                                 wp_dropdown_categories( $dropdown_args ); ?>
168                                 <?php if ( 'category' == $taxonomy ) : ?>
169                                 <p class="description"><?php _e('Categories, unlike tags, can have a hierarchy. You might have a Jazz category, and under that have children categories for Bebop and Big Band. Totally optional.'); ?></p>
170                                 <?php endif; ?>
171                         </td>
172                 </tr>
173 <?php endif; // is_taxonomy_hierarchical() ?>
174                 <tr class="form-field term-description-wrap">
175                         <th scope="row"><label for="description"><?php _e( 'Description' ); ?></label></th>
176                         <td><textarea name="description" id="description" rows="5" cols="50" class="large-text"><?php echo $tag->description; // textarea_escaped ?></textarea>
177                         <p class="description"><?php _e('The description is not prominent by default; however, some themes may show it.'); ?></p></td>
178                 </tr>
179                 <?php
180                 // Back compat hooks
181                 if ( 'category' == $taxonomy ) {
182                         /**
183                          * Fires after the Edit Category form fields are displayed.
184                          *
185                          * @since 2.9.0
186                          * @deprecated 3.0.0 Use {$taxonomy}_edit_form_fields instead.
187                          *
188                          * @param object $tag Current category term object.
189                          */
190                         do_action( 'edit_category_form_fields', $tag );
191                 } elseif ( 'link_category' == $taxonomy ) {
192                         /**
193                          * Fires after the Edit Link Category form fields are displayed.
194                          *
195                          * @since 2.9.0
196                          * @deprecated 3.0.0 Use {$taxonomy}_edit_form_fields instead.
197                          *
198                          * @param object $tag Current link category term object.
199                          */
200                         do_action( 'edit_link_category_form_fields', $tag );
201                 } else {
202                         /**
203                          * Fires after the Edit Tag form fields are displayed.
204                          *
205                          * @since 2.9.0
206                          * @deprecated 3.0.0 Use {$taxonomy}_edit_form_fields instead.
207                          *
208                          * @param object $tag Current tag term object.
209                          */
210                         do_action( 'edit_tag_form_fields', $tag );
211                 }
212                 /**
213                  * Fires after the Edit Term form fields are displayed.
214                  *
215                  * The dynamic portion of the hook name, `$taxonomy`, refers to
216                  * the taxonomy slug.
217                  *
218                  * @since 3.0.0
219                  *
220                  * @param object $tag      Current taxonomy term object.
221                  * @param string $taxonomy Current taxonomy slug.
222                  */
223                 do_action( "{$taxonomy}_edit_form_fields", $tag, $taxonomy );
224                 ?>
225         </table>
226 <?php
227 // Back compat hooks
228 if ( 'category' == $taxonomy ) {
229         /** This action is documented in wp-admin/edit-tags.php */
230         do_action( 'edit_category_form', $tag );
231 } elseif ( 'link_category' == $taxonomy ) {
232         /** This action is documented in wp-admin/edit-tags.php */
233         do_action( 'edit_link_category_form', $tag );
234 } else {
235         /**
236          * Fires at the end of the Edit Term form.
237          *
238          * @since 2.5.0
239          * @deprecated 3.0.0 Use {$taxonomy}_edit_form instead.
240          *
241          * @param object $tag Current taxonomy term object.
242          */
243         do_action( 'edit_tag_form', $tag );
244 }
245 /**
246  * Fires at the end of the Edit Term form for all taxonomies.
247  *
248  * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
249  *
250  * @since 3.0.0
251  *
252  * @param object $tag      Current taxonomy term object.
253  * @param string $taxonomy Current taxonomy slug.
254  */
255 do_action( "{$taxonomy}_edit_form", $tag, $taxonomy );
256
257 submit_button( __('Update') );
258 ?>
259 </form>
260 </div>
261
262 <?php if ( ! wp_is_mobile() ) : ?>
263 <script type="text/javascript">
264 try{document.forms.edittag.name.focus();}catch(e){}
265 </script>
266 <?php endif;