WordPress.org
Get WordPress

Making WordPress.org


Ignore:
Timestamp:
09/05/2022 05:14:31 AM (3 years ago)
Author:
dufresnesteven
Message:

wporg-developer: Sync with ​https://github.com/WordPress/wporg-developer/commit/790d402933d2725374de0d19e6bf6a576c8b15d2

File:
1 edited

Legend:

Unmodified
Added
Removed

  • sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/functions.php

    r11903 r12050  
    148148add_action( 'widgets_init', __NAMESPACE__ . '\\widgets_init' );
    149149
     150/**
     151 * Set up the theme.
     152 */
    150153function init() {
    151154
    … …  
    165168
    166169    // Modify default breadcrumbs.
    167     add_filter( 'breadcrumb_trail_items',  __NAMESPACE__ . '\\breadcrumb_trail_items_for_hooks', 10, 2 );
    168     add_filter( 'breadcrumb_trail_items',  __NAMESPACE__ . '\\breadcrumb_trail_items_for_handbook_root', 10, 2 );
    169 
    170     add_filter( 'syntaxhighlighter_htmlresult', __NAMESPACE__ . '\\syntaxhighlighter_htmlresult' );
     170    add_filter( 'breadcrumb_trail_items', __NAMESPACE__ . '\\breadcrumb_trail_items_for_hooks', 10, 2 );
     171    add_filter( 'breadcrumb_trail_items', __NAMESPACE__ . '\\breadcrumb_trail_items_for_handbook_root', 10, 2 );
     172
     173    add_filter( 'mkaz_code_syntax_force_loading', '__return_true' );
     174    add_filter( 'mkaz_prism_css_path', __NAMESPACE__ . '\\update_prism_css_path' );
    171175}
    172176
    … …  
    178182 * be shown.
    179183 *
    180  * @param  array $items The breadcrumb trail items
    181  * @param  array $args  Original args
     184 * @param  array $items The breadcrumb trail items.
     185 * @param  array $args  Original args.
    182186 * @return array
    183187 */
    … …  
    186190
    187191    // Bail early when not the single archive for hook
    188     if ( ! is_singular() || $post_type !== get_post_type() || ! isset( $items[4] ) ) {
     192    if ( ! is_singular() || get_post_type() !== $post_type || ! isset( $items[4] ) ) {
    189193        return $items;
    190194    }
    … …  
    209213 * item is already the unlinked handbook name, which is sufficient.
    210214 *
    211  * @param  array $items The breadcrumb trail items
    212  * @param  array $args  Original args
     215 * @param  array $items The breadcrumb trail items.
     216 * @param  array $args  Original args.
    213217 * @return array
    214218 */
    … …  
    226230
    227231/**
    228  * widgets_init function.
     232 * Register widget areas.
    229233 *
    230234 * @access public
    … …  
    232236 */
    233237function widgets_init() {
    234     register_sidebar( array(
    235         'name'          => __( 'Sidebar', 'wporg' ),
    236         'id'            => 'sidebar-1',
    237         'before_widget' => '<aside id="%1$s" class="box gray widget %2$s">',
    238         'after_widget'  => '</div></aside>',
    239         'before_title'  => '<h1 class="widget-title">',
    240         'after_title'   => '</h1><div class="widget-content">',
    241     ) );
    242 
    243     register_sidebar( array(
    244         'name'          => __( 'Landing Page Footer - Left', 'wporg' ),
    245         'id'            => 'landing-footer-1',
    246         'description'   => __( 'Appears in footer of the primary landing page', 'wporg' ),
    247         'before_widget' => '<div id="%1$s" class="widget box %2$s">',
    248         'after_widget'  => '</div>',
    249         'before_title'  => '<h4 class="widget-title">',
    250         'after_title'   => '</h4>',
    251     ) );
    252 
    253     register_sidebar( array(
    254         'name'          => __( 'Landing Page Footer - Center', 'wporg' ),
    255         'id'            => 'landing-footer-2',
    256         'description'   => __( 'Appears in footer of the primary landing page', 'wporg' ),
    257         'before_widget' => '<div id="%1$s" class="widget box %2$s">',
    258         'after_widget'  => '</div>',
    259         'before_title'  => '<h4 class="widget-title">',
    260         'after_title'   => '</h4>',
    261     ) );
    262 
    263     register_sidebar( array(
    264         'name'          => __( 'Landing Page Footer - Right', 'wporg' ),
    265         'id'            => 'landing-footer-3',
    266         'description'   => __( 'Appears in footer of the primary landing page', 'wporg' ),
    267         'before_widget' => '<div id="%1$s" class="widget box %2$s">',
    268         'after_widget'  => '</div>',
    269         'before_title'  => '<h4 class="widget-title">',
    270         'after_title'   => '</h4>',
    271     ) );
    272 }
    273 
    274 /**
     238    register_sidebar(
     239        array(
     240            'name'          => __( 'Sidebar', 'wporg' ),
     241            'id'            => 'sidebar-1',
     242            'before_widget' => '<aside id="%1$s" class="box gray widget %2$s">',
     243            'after_widget'  => '</div></aside>',
     244            'before_title'  => '<h1 class="widget-title">',
     245            'after_title'   => '</h1><div class="widget-content">',
     246        )
     247    );
     248
     249    register_sidebar(
     250        array(
     251            'name'          => __( 'Landing Page Footer - Left', 'wporg' ),
     252            'id'            => 'landing-footer-1',
     253            'description'   => __( 'Appears in footer of the primary landing page', 'wporg' ),
     254            'before_widget' => '<div id="%1$s" class="widget box %2$s">',
     255            'after_widget'  => '</div>',
     256            'before_title'  => '<h4 class="widget-title">',
     257            'after_title'   => '</h4>',
     258        )
     259    );
     260
     261    register_sidebar(
     262        array(
     263            'name'          => __( 'Landing Page Footer - Center', 'wporg' ),
     264            'id'            => 'landing-footer-2',
     265            'description'   => __( 'Appears in footer of the primary landing page', 'wporg' ),
     266            'before_widget' => '<div id="%1$s" class="widget box %2$s">',
     267            'after_widget'  => '</div>',
     268            'before_title'  => '<h4 class="widget-title">',
     269            'after_title'   => '</h4>',
     270        )
     271    );
     272
     273    register_sidebar(
     274        array(
     275            'name'          => __( 'Landing Page Footer - Right', 'wporg' ),
     276            'id'            => 'landing-footer-3',
     277            'description'   => __( 'Appears in footer of the primary landing page', 'wporg' ),
     278            'before_widget' => '<div id="%1$s" class="widget box %2$s">',
     279            'after_widget'  => '</div>',
     280            'before_title'  => '<h4 class="widget-title">',
     281            'after_title'   => '</h4>',
     282        )
     283    );
     284}
     285
     286/**
     287 * Modify the default query.
     288 *
    275289 * @param \WP_Query $query
    276290 */
    … …  
    289303}
    290304
     305/**
     306 * Regiser navigation menu area.
     307 */
    291308function register_nav_menus() {
    292 
    293     \register_nav_menus( array(
    294         'devhub-menu' => __( 'Developer Resources Menu', 'wporg' ),
    295         'devhub-cli-menu' => __( 'WP-CLI Commands Menu', 'wporg' ),
    296         'reference-home-api' => __( 'Reference API Menu', 'wporg' ),
    297     ) );
     309    \register_nav_menus(
     310        array(
     311            'devhub-menu' => __( 'Developer Resources Menu', 'wporg' ),
     312            'devhub-cli-menu' => __( 'WP-CLI Commands Menu', 'wporg' ),
     313            'reference-home-api' => __( 'Reference API Menu', 'wporg' ),
     314        )
     315    );
    298316}
    299317
    … …  
    319337}
    320338
     339/**
     340 * Filer the permalink for a taxonomy.
     341 */
    321342function taxonomy_permalink( $link, $term, $taxonomy ) {
    322343    global $wp_rewrite;
    … …  
    326347    }
    327348
    328     if ( $taxonomy === 'wp-parser-source-file' ) {
     349    if ( 'wp-parser-source-file' === $taxonomy ) {
    329350        $slug = $term->slug;
    330351        if ( substr( $slug, -4 ) === '-php' ) {
    … …  
    333354        }
    334355        $link = home_url( user_trailingslashit( "reference/files/$slug" ) );
    335     } elseif ( $taxonomy === 'wp-parser-since' ) {
     356    } elseif ( 'wp-parser-since' === $taxonomy ) {
    336357        $link = str_replace( $term->slug, str_replace( '-', '.', $term->slug ), $link );
    337358    }
     359
    338360    return $link;
    339361}
    … …  
    354376}
    355377
     378/**
     379 * Register and enqueue the theme assets.
     380 */
    356381function theme_scripts_styles() {
    357382    wp_enqueue_style( 'dashicons' );
     383    // phpcs:ignore WordPress.WP.EnqueuedResourceParameters.MissingVersion
    358384    wp_enqueue_style( 'open-sans', '//fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,400,300,600' );
    359     wp_enqueue_style( 'wporg-developer-style', get_stylesheet_uri(), array(), '4' );
     385    wp_enqueue_style( 'wporg-developer-style', get_stylesheet_uri(), array(), filemtime( __DIR__ . '/style.css' ) );
    360386    wp_enqueue_style(
    361387        'wp-dev-sass-compiled',
    … …  
    364390        filemtime( __DIR__ . '/stylesheets/main.css' )
    365391    );
    366     wp_enqueue_script( 'wporg-developer-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '20181209', true );
    367     wp_enqueue_script( 'wporg-developer-skip-link-focus-fix', get_template_directory_uri() . '/js/skip-link-focus-fix.js', array(), '20130115', true );
    368     wp_enqueue_script( 'wporg-developer-search', get_template_directory_uri() . '/js/search.js', array(), '20150430', true );
    369     wp_enqueue_script( 'wporg-developer-chapters', get_template_directory_uri() . '/js/chapters.js', array( 'jquery' ), '20190603' );
    370     wp_enqueue_script( 'wporg-developer-menu', get_template_directory_uri() . '/js/menu.js', array( 'jquery' ), '20180201', true );
     392    wp_enqueue_script( 'wporg-developer-navigation', get_stylesheet_directory_uri() . '/js/navigation.js', array(), filemtime( __DIR__ . '/js/navigation.js' ), true );
     393    wp_enqueue_script( 'wporg-developer-chapters', get_stylesheet_directory_uri() . '/js/chapters.js', array( 'jquery' ), filemtime( __DIR__ . '/js/chapters.js' ) );
     394    wp_enqueue_script( 'wporg-developer-menu', get_stylesheet_directory_uri() . '/js/menu.js', array( 'jquery' ), filemtime( __DIR__ . '/js/menu.js' ), true );
    371395}
    372396
    … …  
    385409
    386410/**
    387  * If a syntax highlighted code block exceeds a given number of lines, wrap the
    388  * markup with other markup to trigger the code expansion/collapse JS handling
    389  * already implemented for the code reference.
    390  *
    391  * @param string  $text The pending result of the syntax highlighting.
     411 * Customize the syntax highlighter style.
     412 * See https://github.com/PrismJS/prism-themes.
     413 *
     414 * @param string $path Path to the file to override, relative to the theme.
    392415 * @return string
    393416 */
    394 function syntaxhighlighter_htmlresult( $text ) {
    395 
    396     // is_admin() is true in front end AJAX requests.
    397     if ( is_admin() && !( defined( 'DOING_AJAX' ) && DOING_AJAX ) ) {
    398         return $text;
    399     }
    400 
    401     $new_text      = '';
    402     // Collapse is handled for >10 lines. But just go ahead and show the full
    403     // code if that is just barely being exceeded (no one wants to expand to
    404     // see one or two more lines).
    405     $lines_to_show = 12;
    406     $do_collapse   = ( substr_count( $text, "\n" ) - 1 ) > $lines_to_show;
    407 
    408     if ( $do_collapse )  {
    409         $new_text .= '<section class="source-content">';
    410         $new_text .= '<div class="source-code-container">';
    411     }
    412 
    413     $new_text .= $text;
    414 
    415     if ( $do_collapse ) {
    416         $new_text .= '</div>';
    417         $new_text .= '<p class="source-code-links"><span>';
    418         $new_text .= '<a href="#" class="show-complete-source">' . __( 'Expand full source code', 'wporg' ) . '</a>';
    419         $new_text .= '<a href="#" class="less-complete-source">' . __( 'Collapse full source code', 'wporg' ) . '</a>';
    420         $new_text .= '</span></p>';
    421         $new_text .= '</section>';
    422     }
    423 
    424     return $new_text;
    425 }
     417function update_prism_css_path( $path ) {
     418    return '/stylesheets/prism.css';
     419}
Note: See TracChangeset for help on using the changeset viewer.