$base_slug ) { $url .= '&sub=' . $slug; } } else { $url = 'admin.php?page=' . $slug; } if ( 'network' === $context || 'snippets-settings' === $slug ) { return network_admin_url( $url ); } elseif ( 'admin' === $context ) { return admin_url( $url ); } else { return self_admin_url( $url ); } } /** * Fetch the admin menu slug for a snippets menu * * @param int $snippet_id Snippet ID. * @param string $context URL scheme to use. * * @return string The URL to the edit snippet page for that snippet. */ public function get_snippet_edit_url( $snippet_id, $context = 'self' ) { return add_query_arg( 'id', absint( $snippet_id ), $this->get_menu_url( 'edit', $context ) ); } /** * Determine whether the current user can perform actions on snippets. * * @return boolean Whether the current user has the required capability * @since 2.8.6 */ public function current_user_can() { return current_user_can( $this->get_cap() ); } /** * Retrieve the name of the capability required to manage sub-site snippets * * @return string */ public function get_cap_name() { return apply_filters( 'code_snippets_cap', 'manage_options' ); } /** * Retrieve the name of the capability required to manage network snippets * * @return string */ public function get_network_cap_name() { return apply_filters( 'code_snippets_network_cap', 'manage_network_options' ); } /** * Get the required capability to perform a certain action on snippets. * Does not check if the user has this capability or not. * * If multisite, checks if *Enable Administration Menus: Snippets* is active * under the *Settings > Network Settings* network admin menu * * @return string The capability required to manage snippets * @since 2.0 */ public function get_cap() { if ( is_multisite() ) { $menu_perms = get_site_option( 'menu_items', array() ); /* If multisite is enabled and the snippet menu is not activated, restrict snippet operations to super admins only */ if ( empty( $menu_perms['snippets'] ) ) { return $this->get_network_cap_name(); } } return $this->get_cap_name(); } /** * Inject the safe mode query var into URLs * * @param string $url Original URL. * * @return string Modified URL. */ public function add_safe_mode_query_var( $url ) { if ( isset( $_REQUEST['snippets-safe-mode'] ) ) { return add_query_arg( 'snippets-safe-mode', (bool) $_REQUEST['snippets-safe-mode'], $url ); } return $url; } /** * Retrieve a list of available snippet types and their labels. * * @return array */ public static function get_types() { return apply_filters( 'code_snippets_types', array( 'php' => __( 'Functions', 'code-snippets' ), 'html' => __( 'Content', 'code-snippets' ), 'css' => __( 'Styles', 'code-snippets' ), 'js' => __( 'Scripts', 'code-snippets' ), ) ); } /** * Determine whether a snippet type is Pro-only. * * @param string $type Snippet type name. * * @return bool */ public static function is_pro_type( $type ) { return 'css' === $type || 'js' === $type; } /** * Retrieve the description for a particular snippet type. * * @param string $type Snippet type name. * * @return string */ public function get_type_description( $type ) { $descriptions = array( 'php' => __( 'Function snippets are run on your site as if there were in a plugin or theme functions.php file.', 'code-snippets' ), 'html' => __( 'Content snippets are bits of reusable PHP and HTML content that can be inserted into posts and pages.', 'code-snippets' ), 'css' => __( 'Style snippets are written in CSS and loaded in the admin area or on the site front-end, just like the theme style.css.', 'code-snippets' ), 'js' => __( 'Script snippets are loaded on the site front-end in a JavaScript file, either in the head or body sections.', 'code-snippets' ), ); $descriptions = apply_filters( 'code_snippets/plugins/type_descriptions', $descriptions ); return isset( $descriptions[ $type ] ) ? $descriptions[ $type ] : ''; } }