Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.
 
 
 
 
 

234 lignes
6.0 KiB

  1. <?php
  2. /**
  3. * WordPress Administration Screen API.
  4. *
  5. * @package WordPress
  6. * @subpackage Administration
  7. */
  8. /**
  9. * Get the column headers for a screen
  10. *
  11. * @since 2.7.0
  12. *
  13. * @staticvar array $column_headers
  14. *
  15. * @param string|WP_Screen $screen The screen you want the headers for
  16. * @return array Containing the headers in the format id => UI String
  17. */
  18. function get_column_headers( $screen ) {
  19. if ( is_string( $screen ) )
  20. $screen = convert_to_screen( $screen );
  21. static $column_headers = array();
  22. if ( ! isset( $column_headers[ $screen->id ] ) ) {
  23. /**
  24. * Filters the column headers for a list table on a specific screen.
  25. *
  26. * The dynamic portion of the hook name, `$screen->id`, refers to the
  27. * ID of a specific screen. For example, the screen ID for the Posts
  28. * list table is edit-post, so the filter for that screen would be
  29. * manage_edit-post_columns.
  30. *
  31. * @since 3.0.0
  32. *
  33. * @param array $columns An array of column headers. Default empty.
  34. */
  35. $column_headers[ $screen->id ] = apply_filters( "manage_{$screen->id}_columns", array() );
  36. }
  37. return $column_headers[ $screen->id ];
  38. }
  39. /**
  40. * Get a list of hidden columns.
  41. *
  42. * @since 2.7.0
  43. *
  44. * @param string|WP_Screen $screen The screen you want the hidden columns for
  45. * @return array
  46. */
  47. function get_hidden_columns( $screen ) {
  48. if ( is_string( $screen ) ) {
  49. $screen = convert_to_screen( $screen );
  50. }
  51. $hidden = get_user_option( 'manage' . $screen->id . 'columnshidden' );
  52. $use_defaults = ! is_array( $hidden );
  53. if ( $use_defaults ) {
  54. $hidden = array();
  55. /**
  56. * Filters the default list of hidden columns.
  57. *
  58. * @since 4.4.0
  59. *
  60. * @param array $hidden An array of columns hidden by default.
  61. * @param WP_Screen $screen WP_Screen object of the current screen.
  62. */
  63. $hidden = apply_filters( 'default_hidden_columns', $hidden, $screen );
  64. }
  65. /**
  66. * Filters the list of hidden columns.
  67. *
  68. * @since 4.4.0
  69. * @since 4.4.1 Added the `use_defaults` parameter.
  70. *
  71. * @param array $hidden An array of hidden columns.
  72. * @param WP_Screen $screen WP_Screen object of the current screen.
  73. * @param bool $use_defaults Whether to show the default columns.
  74. */
  75. return apply_filters( 'hidden_columns', $hidden, $screen, $use_defaults );
  76. }
  77. /**
  78. * Prints the meta box preferences for screen meta.
  79. *
  80. * @since 2.7.0
  81. *
  82. * @global array $wp_meta_boxes
  83. *
  84. * @param WP_Screen $screen
  85. */
  86. function meta_box_prefs( $screen ) {
  87. global $wp_meta_boxes;
  88. if ( is_string( $screen ) )
  89. $screen = convert_to_screen( $screen );
  90. if ( empty($wp_meta_boxes[$screen->id]) )
  91. return;
  92. $hidden = get_hidden_meta_boxes($screen);
  93. foreach ( array_keys( $wp_meta_boxes[ $screen->id ] ) as $context ) {
  94. foreach ( array( 'high', 'core', 'default', 'low' ) as $priority ) {
  95. if ( ! isset( $wp_meta_boxes[ $screen->id ][ $context ][ $priority ] ) ) {
  96. continue;
  97. }
  98. foreach ( $wp_meta_boxes[ $screen->id ][ $context ][ $priority ] as $box ) {
  99. if ( false == $box || ! $box['title'] )
  100. continue;
  101. // Submit box cannot be hidden
  102. if ( 'submitdiv' == $box['id'] || 'linksubmitdiv' == $box['id'] )
  103. continue;
  104. $widget_title = $box['title'];
  105. if ( is_array( $box['args'] ) && isset( $box['args']['__widget_basename'] ) ) {
  106. $widget_title = $box['args']['__widget_basename'];
  107. }
  108. printf(
  109. '<label for="%1$s-hide"><input class="hide-postbox-tog" name="%1$s-hide" type="checkbox" id="%1$s-hide" value="%1$s" %2$s />%3$s</label>',
  110. esc_attr( $box['id'] ),
  111. checked( in_array( $box['id'], $hidden ), false, false ),
  112. $widget_title
  113. );
  114. }
  115. }
  116. }
  117. }
  118. /**
  119. * Get Hidden Meta Boxes
  120. *
  121. * @since 2.7.0
  122. *
  123. * @param string|WP_Screen $screen Screen identifier
  124. * @return array Hidden Meta Boxes
  125. */
  126. function get_hidden_meta_boxes( $screen ) {
  127. if ( is_string( $screen ) )
  128. $screen = convert_to_screen( $screen );
  129. $hidden = get_user_option( "metaboxhidden_{$screen->id}" );
  130. $use_defaults = ! is_array( $hidden );
  131. // Hide slug boxes by default
  132. if ( $use_defaults ) {
  133. $hidden = array();
  134. if ( 'post' == $screen->base ) {
  135. if ( 'post' == $screen->post_type || 'page' == $screen->post_type || 'attachment' == $screen->post_type )
  136. $hidden = array('slugdiv', 'trackbacksdiv', 'postcustom', 'postexcerpt', 'commentstatusdiv', 'commentsdiv', 'authordiv', 'revisionsdiv');
  137. else
  138. $hidden = array( 'slugdiv' );
  139. }
  140. /**
  141. * Filters the default list of hidden meta boxes.
  142. *
  143. * @since 3.1.0
  144. *
  145. * @param array $hidden An array of meta boxes hidden by default.
  146. * @param WP_Screen $screen WP_Screen object of the current screen.
  147. */
  148. $hidden = apply_filters( 'default_hidden_meta_boxes', $hidden, $screen );
  149. }
  150. /**
  151. * Filters the list of hidden meta boxes.
  152. *
  153. * @since 3.3.0
  154. *
  155. * @param array $hidden An array of hidden meta boxes.
  156. * @param WP_Screen $screen WP_Screen object of the current screen.
  157. * @param bool $use_defaults Whether to show the default meta boxes.
  158. * Default true.
  159. */
  160. return apply_filters( 'hidden_meta_boxes', $hidden, $screen, $use_defaults );
  161. }
  162. /**
  163. * Register and configure an admin screen option
  164. *
  165. * @since 3.1.0
  166. *
  167. * @param string $option An option name.
  168. * @param mixed $args Option-dependent arguments.
  169. */
  170. function add_screen_option( $option, $args = array() ) {
  171. $current_screen = get_current_screen();
  172. if ( ! $current_screen )
  173. return;
  174. $current_screen->add_option( $option, $args );
  175. }
  176. /**
  177. * Get the current screen object
  178. *
  179. * @since 3.1.0
  180. *
  181. * @global WP_Screen $current_screen
  182. *
  183. * @return WP_Screen|null Current screen object or null when screen not defined.
  184. */
  185. function get_current_screen() {
  186. global $current_screen;
  187. if ( ! isset( $current_screen ) )
  188. return null;
  189. return $current_screen;
  190. }
  191. /**
  192. * Set the current screen object
  193. *
  194. * @since 3.0.0
  195. *
  196. * @param mixed $hook_name Optional. The hook name (also known as the hook suffix) used to determine the screen,
  197. * or an existing screen object.
  198. */
  199. function set_current_screen( $hook_name = '' ) {
  200. WP_Screen::get( $hook_name )->set_current_screen();
  201. }