WordPress.org
Get WordPress

Making WordPress.org


Ignore:
Timestamp:
07/24/2018 05:27:23 PM (6 years ago)
Author:
obenland
Message:

DevHub: Add short descriptions to Related section

Props keesiemeijer, kevinwhoffman.
Fixes #1847.

File:
1 edited

Legend:

Unmodified
Added
Removed

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

    r5597 r7491  
    1414    $has_used_by = ( post_type_has_usage_info() && ( $used_by = get_used_by() ) && $used_by->have_posts() );
    1515
     16    $uses_to_show    = 5;
     17    $used_by_to_show = 5;
     18
    1619    if ( $has_uses || $has_used_by ) :
    1720    ?>
    … …  
    2326            <article class="uses">
    2427                <h3><?php _e( 'Uses', 'wporg' ); ?></h3>
    25                 <ul>
    26                     <?php
    27                     $uses_to_show = 5;
    28                     while ( $uses->have_posts() ) : $uses->the_post()
    29                         ?>
    30                         <li>
    31                             <span><?php echo esc_attr( get_source_file() ); ?>:</span>
    32                             <a href="<?php the_permalink(); ?>"><?php the_title(); ?><?php if ( ! in_array( get_post_type(), array( 'wp-parser-class', 'wp-parser-hook' ) ) ) : ?>()<?php endif; ?></a>
    33                         </li>
    34                     <?php endwhile; wp_reset_postdata(); ?>
    35                     <?php if ( $uses->post_count > $uses_to_show ) : ?>
    36                         <a href="#" class="show-more"><?php
    37                             /* translators: %d: remaining 'uses' count */
    38                             printf( _n( 'Show %d more use', 'Show %d more uses', $uses->post_count - $uses_to_show, 'wporg' ),
    39                                 number_format_i18n( $uses->post_count - $uses_to_show )
    40                             );
    41                             ?></a>
    42                         <a href="#" class="hide-more"><?php _e( 'Hide more uses', 'wporg' ); ?></a>
    43                     <?php endif; ?>
    44                 </ul>
     28                <table id="uses-table">
     29                    <caption class="screen-reader-text"><?php esc_html_e( 'Uses', 'wporg' ); ?></caption>
     30                    <thead>
     31                        <tr>
     32                            <th><?php esc_html_e( 'Uses', 'wporg' ); ?></th>
     33                            <th class="related-desc"><?php esc_html_e( 'Description', 'wporg' ); ?></th>
     34                        </tr>
     35                    </thead>
     36                    <tbody>
     37                        <?php while ( $uses->have_posts() ) : $uses->the_post(); ?>
     38                        <tr>
     39                            <td>
     40                                <span><?php echo esc_attr( get_source_file() ); ?>:</span>
     41                                <a href="<?php the_permalink(); ?>"><?php the_title(); ?><?php if ( ! in_array( get_post_type(), array( 'wp-parser-class', 'wp-parser-hook' ), true ) ) : ?>()<?php endif; ?></a>
     42                            </td>
     43                            <td class="related-desc">
     44                                <?php echo get_summary(); ?>
     45                            </td>
     46                        </tr>
     47                        <?php endwhile; wp_reset_postdata(); ?>
     48                    <tbody>
     49                </table>
     50
     51                <?php if ( $uses->post_count > $uses_to_show ) : ?>
     52                <a href="#" class="show-more"><?php
     53                    /* translators: %d: remaining 'uses' count */
     54                    printf( _n( 'Show %d more use', 'Show %d more uses', $uses->post_count - $uses_to_show, 'wporg' ),
     55                        number_format_i18n( $uses->post_count - $uses_to_show )
     56                    );
     57                    ?></a>
     58                <a href="#" class="hide-more"><?php esc_html_e( 'Hide more uses', 'wporg' ); ?></a>
     59                <?php endif; ?>
    4560            </article>
    4661        <?php endif; ?>
    4762
    4863        <?php if ( $has_used_by ) : ?>
     64            <?php if ( $has_uses && $uses->post_count > $uses_to_show ) : ?><hr /><?php endif; ?>
    4965
    50         <?php if ( $has_uses ) { ?><hr /><?php } ?>
     66            <article class="used-by">
     67                <h3><?php esc_html_e( 'Used By', 'wporg' ); ?></h3>
     68                <table id="used-by-table">
     69                    <caption class="screen-reader-text"><?php esc_html_e( 'Used By', 'wporg' ); ?></caption>
     70                    <thead>
     71                        <tr>
     72                            <th><?php esc_html_e( 'Used By', 'wporg' ); ?></th>
     73                            <th class="related-desc"><?php esc_html_e( 'Description', 'wporg' ); ?></th>
     74                        </tr>
     75                    </thead>
     76                    <tbody>
     77                        <?php while ( $used_by->have_posts() ) : $used_by->the_post(); ?>
     78                        <tr>
     79                            <td>
     80                                <span><?php echo esc_attr( get_source_file() ); ?>:</span>
     81                                <a href="<?php the_permalink(); ?>"><?php the_title(); ?><?php if ( ! in_array( get_post_type(), array( 'wp-parser-class', 'wp-parser-hook' ), true ) ) : ?>()<?php endif; ?></a>
     82                            </td>
     83                            <td class="related-desc">
     84                                <?php echo get_summary(); ?>
     85                            </td>
     86                        </tr>
     87                        <?php endwhile; wp_reset_postdata(); ?>
     88                    <tbody>
     89                </table>
    5190
    52         <article class="used-by">
    53             <h3><?php _e( 'Used By', 'wporg' ); ?></h3>
    54             <ul>
    55                 <?php
    56                 $used_by_to_show = 5;
    57                 while ( $used_by->have_posts() ) : $used_by->the_post();
    58                     ?>
    59                     <li>
    60                         <span><?php echo esc_attr( get_source_file() ); ?>:</span>
    61                         <a href="<?php the_permalink(); ?>"><?php the_title(); ?><?php if ( ! in_array( get_post_type(), array( 'wp-parser-class', 'wp-parser-hook' ) ) ) : ?>()<?php endif; ?></a>
    62                     </li>
    63                 <?php endwhile; wp_reset_postdata(); ?>
    6491                <?php if ( $used_by->post_count > $used_by_to_show ) : ?>
    65                     <a href="#" class="show-more"><?php
    66                         /* translators: %d: remaining 'used by' count */
    67                         printf( _n( 'Show %d more used by', 'Show %d more used by', $used_by->post_count - $used_by_to_show, 'wporg' ),
    68                             number_format_i18n( $used_by->post_count - $used_by_to_show )
    69                         );
    70                         ?></a>
    71                     <a href="#" class="hide-more"><?php _e( 'Hide more used by', 'wporg' ); ?></a>
     92                <a href="#" class="show-more"><?php
     93                    /* translators: %d: remaining 'used by' count */
     94                    printf( _n( 'Show %d more used by', 'Show %d more used by', $used_by->post_count - $used_by_to_show, 'wporg' ),
     95                        number_format_i18n( $used_by->post_count - $used_by_to_show )
     96                    );
     97                    ?></a>
     98                <a href="#" class="hide-more"><?php esc_html_e( 'Hide more used by', 'wporg' ); ?></a>
    7299                <?php endif; ?>
    73             </ul>
    74         </article>
     100            </article>
    75101        <?php endif; ?>
    76 
    77102    </section>
    78103    <?php endif; ?>
Note: See TracChangeset for help on using the changeset viewer.