Changeset 3563

Timestamp:

06/23/2016 06:59:17 PM (8 years ago)

Author:

coffee2code

Message:

developer.wordpress.org: Implement Handbooks table of contents functionality for the "More Information" sections of parsed post types.

Props DrewAPicture.
Fixes #1548.

Location:

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

Files:

• content-reference.php (modified) (1 diff)
• inc/template-tags.php (modified) (1 diff)
• scss/main.scss (modified) (3 diffs)
• stylesheets/main.css (modified) (3 diffs)

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

@@ -84 +84 @@
         <section class="explanation">
             <h2><?php _e( 'More Information', 'wporg' ); ?></h2>
-            <?php echo apply_filters( 'the_content', apply_filters( 'get_the_content', $explanation ) ); ?>
+
+            <?php
+            // Output the explanation. Passed through 'the_content' on retrieval, thus no escaping.
+            echo $explanation;
+            ?>
         </section>
     <?php endif; ?>

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/template-tags.php

@@ -1318 +1318 @@
             return '';
         }
-        return get_post_field( $field, $explanation, $context );
+
+        $post_field = get_post_field( $field, $explanation, $context );
+
+        // If retrieving the explanation content for display, add the TOC if available.
+        if ( 'post_content' === $field && 'display' === $context ) {
+            if ( class_exists( 'WPorg_Handbook_TOC' ) ) :
+                $TOC = new \WPorg_Handbook_TOC( get_parsed_post_types() );
+
+                add_filter( 'the_content', array( $TOC, 'add_toc' ) );
+                $post_field = apply_filters( 'the_content', apply_filters( 'get_the_content', $post_field ) );
+                remove_filter( 'the_content', array( $TOC, 'add_toc' ) );
+            else :
+                $post_field = apply_filters( 'the_content', apply_filters( 'get_the_content', $post_field ) );
+            endif;
+        }
+
+        return $post_field;
     }
 

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/scss/main.scss

@@ -1054 +1054 @@
             margin-top: 30px;
         }
+        .table-of-contents {
+            width: 300px;
+        }
     }
 
@@ -1611 +1614 @@
                 text-indent: -45px;
             }
+
+            .table-of-contents {
+                width: 200px;
+            }
         }
 
@@ -1642 +1649 @@
                 font-size: 16px;
             }
+            .table-of-contents {
+                width: 100%;
+                margin-bottom: 10px;
+            }
         }
 

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/stylesheets/main.css

@@ -1263 +1263 @@
   margin-top: 30px;
 }
+.devhub-wrap .wp-parser-class .table-of-contents, .devhub-wrap .wp-parser-function .table-of-contents, .devhub-wrap .wp-parser-hook .table-of-contents, .devhub-wrap .wp-parser-method .table-of-contents {
+  width: 300px;
+}
 .devhub-wrap .callout:before {
   top: 0.2em;
@@ -1669 +1672 @@
     text-indent: -45px;
   }
+  .devhub-wrap .wp-parser-class .table-of-contents, .devhub-wrap .wp-parser-function .table-of-contents, .devhub-wrap .wp-parser-hook .table-of-contents, .devhub-wrap .wp-parser-method .table-of-contents {
+    width: 200px;
+  }
   .devhub-wrap .two-columns .box {
     width: 99%;
@@ -1691 +1697 @@
     font-size: 16px;
   }
+  .devhub-wrap .wp-parser-class .table-of-contents, .devhub-wrap .wp-parser-function .table-of-contents, .devhub-wrap .wp-parser-hook .table-of-contents, .devhub-wrap .wp-parser-method .table-of-contents {
+    width: 100%;
+    margin-bottom: 10px;
+  }
   .devhub-wrap.single-wp-parser-function .comment-list li, .devhub-wrap.single-wp-parser-method .comment-list li, .devhub-wrap.single-wp-parser-hook .comment-list li {
     padding-left: 0;