Nenhuma Descrição

class-menu.php 6.8KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273
  1. <?php
  2. /**
  3. * Register menu elements and do other global tasks.
  4. *
  5. * @since 1.0.0
  6. */
  7. class WPForms_Admin_Menu {
  8. /**
  9. * Primary class constructor.
  10. *
  11. * @since 1.0.0
  12. */
  13. public function __construct() {
  14. // Let's make some menus.
  15. add_action( 'admin_menu', array( $this, 'register_menus' ), 9 );
  16. add_action( 'admin_head', array( $this, 'hide_wpforms_submenu_items' ) );
  17. // Plugins page settings link.
  18. add_filter( 'plugin_action_links_' . plugin_basename( WPFORMS_PLUGIN_DIR . 'wpforms.php' ), array( $this, 'settings_link' ), 10 );
  19. }
  20. /**
  21. * Register our menus.
  22. *
  23. * @since 1.0.0
  24. */
  25. public function register_menus() {
  26. $manage_cap = wpforms_get_capability_manage_options();
  27. $access = wpforms()->get( 'access' );
  28. if ( ! method_exists( $access, 'get_menu_cap' ) ) {
  29. return;
  30. }
  31. // Default Forms top level menu item.
  32. add_menu_page(
  33. esc_html__( 'WPForms', 'wpforms-lite' ),
  34. esc_html__( 'WPForms', 'wpforms-lite' ),
  35. $access->get_menu_cap( 'view_forms' ),
  36. 'wpforms-overview',
  37. array( $this, 'admin_page' ),
  38. 'data:image/svg+xml;base64,' . base64_encode( '<svg width="1792" height="1792" viewBox="0 0 1792 1792" xmlns="http://www.w3.org/2000/svg"><path fill="#9ea3a8" d="M643 911v128h-252v-128h252zm0-255v127h-252v-127h252zm758 511v128h-341v-128h341zm0-256v128h-672v-128h672zm0-255v127h-672v-127h672zm135 860v-1240q0-8-6-14t-14-6h-32l-378 256-210-171-210 171-378-256h-32q-8 0-14 6t-6 14v1240q0 8 6 14t14 6h1240q8 0 14-6t6-14zm-855-1110l185-150h-406zm430 0l221-150h-406zm553-130v1240q0 62-43 105t-105 43h-1240q-62 0-105-43t-43-105v-1240q0-62 43-105t105-43h1240q62 0 105 43t43 105z"/></svg>' ),
  39. apply_filters( 'wpforms_menu_position', '58.9' )
  40. );
  41. // All Forms sub menu item.
  42. add_submenu_page(
  43. 'wpforms-overview',
  44. esc_html__( 'WPForms', 'wpforms-lite' ),
  45. esc_html__( 'All Forms', 'wpforms-lite' ),
  46. $access->get_menu_cap( 'view_forms' ),
  47. 'wpforms-overview',
  48. array( $this, 'admin_page' )
  49. );
  50. // Add New sub menu item.
  51. add_submenu_page(
  52. 'wpforms-overview',
  53. esc_html__( 'WPForms Builder', 'wpforms-lite' ),
  54. esc_html__( 'Add New', 'wpforms-lite' ),
  55. $access->get_menu_cap( array( 'create_forms', 'edit_forms' ) ),
  56. 'wpforms-builder',
  57. array( $this, 'admin_page' )
  58. );
  59. // Entries sub menu item.
  60. add_submenu_page(
  61. 'wpforms-overview',
  62. esc_html__( 'Form Entries', 'wpforms-lite' ),
  63. esc_html__( 'Entries', 'wpforms-lite' ),
  64. $access->get_menu_cap( 'view_entries' ),
  65. 'wpforms-entries',
  66. array( $this, 'admin_page' )
  67. );
  68. do_action_deprecated(
  69. 'wpform_admin_menu',
  70. array( $this ),
  71. '1.5.5 of the WPForms plugin',
  72. 'wpforms_admin_menu'
  73. );
  74. do_action( 'wpforms_admin_menu', $this );
  75. // Settings sub menu item.
  76. add_submenu_page(
  77. 'wpforms-overview',
  78. esc_html__( 'WPForms Settings', 'wpforms-lite' ),
  79. esc_html__( 'Settings', 'wpforms-lite' ),
  80. $manage_cap,
  81. 'wpforms-settings',
  82. array( $this, 'admin_page' )
  83. );
  84. // Tools sub menu item.
  85. add_submenu_page(
  86. 'wpforms-overview',
  87. esc_html__( 'WPForms Tools', 'wpforms-lite' ),
  88. esc_html__( 'Tools', 'wpforms-lite' ),
  89. $access->get_menu_cap( array( 'create_forms', 'view_forms', 'view_entries' ) ),
  90. 'wpforms-tools',
  91. array( $this, 'admin_page' )
  92. );
  93. // Hidden placeholder paged used for misc content.
  94. add_submenu_page(
  95. 'wpforms-settings',
  96. esc_html__( 'WPForms', 'wpforms-lite' ),
  97. esc_html__( 'Info', 'wpforms-lite' ),
  98. $access->get_menu_cap( 'any' ),
  99. 'wpforms-page',
  100. array( $this, 'admin_page' )
  101. );
  102. // Addons submenu page.
  103. add_submenu_page(
  104. 'wpforms-overview',
  105. esc_html__( 'WPForms Addons', 'wpforms-lite' ),
  106. '<span style="color:#f18500">' . esc_html__( 'Addons', 'wpforms-lite' ) . '</span>',
  107. $manage_cap,
  108. 'wpforms-addons',
  109. array( $this, 'admin_page' )
  110. );
  111. // Analytics submenu page.
  112. add_submenu_page(
  113. 'wpforms-overview',
  114. esc_html__( 'Analytics', 'wpforms-lite' ),
  115. esc_html__( 'Analytics', 'wpforms-lite' ),
  116. $manage_cap,
  117. WPForms\Admin\Pages\Analytics::SLUG,
  118. array( $this, 'admin_page' )
  119. );
  120. // SMTP submenu page.
  121. add_submenu_page(
  122. 'wpforms-overview',
  123. esc_html__( 'SMTP', 'wpforms-lite' ),
  124. esc_html__( 'SMTP', 'wpforms-lite' ),
  125. $manage_cap,
  126. WPForms\Admin\Pages\SMTP::SLUG,
  127. array( $this, 'admin_page' )
  128. );
  129. // About submenu page.
  130. add_submenu_page(
  131. 'wpforms-overview',
  132. esc_html__( 'About WPForms', 'wpforms-lite' ),
  133. esc_html__( 'About Us', 'wpforms-lite' ),
  134. $access->get_menu_cap( 'any' ),
  135. WPForms_About::SLUG,
  136. array( $this, 'admin_page' )
  137. );
  138. // Community submenu page.
  139. add_submenu_page(
  140. 'wpforms-overview',
  141. esc_html__( 'Community', 'wpforms-lite' ),
  142. esc_html__( 'Community', 'wpforms-lite' ),
  143. $manage_cap,
  144. WPForms\Admin\Pages\Community::SLUG,
  145. array( $this, 'admin_page' )
  146. );
  147. }
  148. /**
  149. * Hide "Add New" admin menu item if a user can't create forms.
  150. *
  151. * @since 1.5.8
  152. */
  153. public function hide_wpforms_submenu_items() {
  154. if ( wpforms_current_user_can( 'create_forms' ) ) {
  155. return;
  156. }
  157. global $submenu;
  158. if ( ! isset( $submenu['wpforms-overview'] ) ) {
  159. return;
  160. }
  161. foreach ( $submenu['wpforms-overview'] as $key => $item ) {
  162. if ( isset( $item[2] ) && 'wpforms-builder' === $item[2] ) {
  163. unset( $submenu['wpforms-overview'][ $key ] );
  164. break;
  165. }
  166. }
  167. $this->hide_wpforms_menu_item();
  168. }
  169. /**
  170. * Hide "WPForms" admin menu if it has no submenu items.
  171. *
  172. * @since 1.5.8
  173. */
  174. public function hide_wpforms_menu_item() {
  175. global $submenu, $menu;
  176. if ( ! empty( $submenu['wpforms-overview'] ) ) {
  177. return;
  178. }
  179. unset( $submenu['wpforms-overview'] );
  180. foreach ( $menu as $key => $item ) {
  181. if ( isset( $item[2] ) && 'wpforms-overview' === $item[2] ) {
  182. unset( $menu[ $key ] );
  183. break;
  184. }
  185. }
  186. }
  187. /**
  188. * Wrapper for the hook to render our custom settings pages.
  189. *
  190. * @since 1.0.0
  191. */
  192. public function admin_page() {
  193. do_action( 'wpforms_admin_page' );
  194. }
  195. /**
  196. * Add settings link to the Plugins page.
  197. *
  198. * @since 1.3.9
  199. *
  200. * @param array $links Plugin row links.
  201. *
  202. * @return array $links
  203. */
  204. public function settings_link( $links ) {
  205. $custom['settings'] = sprintf(
  206. '<a href="%s" aria-label="%s">%s</a>',
  207. esc_url(
  208. add_query_arg(
  209. array(
  210. 'page' => 'wpforms-settings',
  211. ),
  212. admin_url( 'admin.php' )
  213. )
  214. ),
  215. esc_attr__( 'Go to WPForms Settings page', 'wpforms-lite' ),
  216. esc_html__( 'Settings', 'wpforms-lite' )
  217. );
  218. $custom['support'] = sprintf(
  219. '<a href="%1$s" aria-label="%2$s" style="font-weight:bold;">%3$s</a>',
  220. esc_url(
  221. add_query_arg(
  222. array(
  223. 'page' => 'wpforms-about',
  224. 'view' => 'versus',
  225. ),
  226. admin_url( 'admin.php' )
  227. )
  228. ),
  229. esc_attr__( 'Go to WPForms Lite vs Pro comparison page', 'wpforms-lite' ),
  230. esc_html__( 'Premium Support', 'wpforms-lite' )
  231. );
  232. return array_merge( $custom, (array) $links );
  233. }
  234. }
  235. new WPForms_Admin_Menu();