Before Loop Filter

Author: circuscode

readme.md

@@ -175,6 +175,21 @@ You can use the following code.
     }
     add_filter( 'tootpress_menu_backward_label', 'tootpress_menu_backward_label_change', 10, 1 );
 
+#### tootpress_beforeloop_filter
+
+This filter outputs content before the toot loop (on all tootpress pages).
+You can use the following code.
+
+    function tootpress_beforeloop_filter_add( $content, $page_number ) {
+    
+        // Add your filter code here
+        // Example: $content='<p>Page '.$page_number.'</p>';
+
+        return $label;
+
+    }
+    add_filter( 'tootpress_beforeloop_filter', 'tootpress_beforeloop_filter_add', 10, 2 );
+
 ## WordPress Framework
 
 Following components of WordPress are used in TootPress.
@@ -258,6 +273,7 @@ This project is licensed under the GPL3 License.
 * Feature: Closing Filter
 * Feature: Move Forward Label Filter
 * Feature: Move Backward Label Filter
+* Feature: Before Loop Filter
 
 ### 0.4 "Cassie Lang"
 

readme.txt

@@ -172,6 +172,20 @@ You can use the following code.
 `}`
 `add_filter( 'tootpress_menu_backward_label', 'tootpress_menu_backward_label_change', 10, 1 );`
 
+**Filter: tootpress_beforeloop_filter**  
+This filter outputs content before the toot loop (on all tootpress pages).  
+You can use the following code.
+
+`function tootpress_beforeloop_filter_add( $content, $page_number ) {`
+``
+`    // Add your filter code here`
+`    // Example: $content='<p>Page '.$page_number.'</p>';`
+``
+`    return $label;`
+``
+`}`
+`add_filter( 'tootpress_beforeloop_filter', 'tootpress_beforeloop_filter_add', 10, 2 );`
+
 = Related Links =
 
 * [Source Code @ GitHub](https://github.com/circuscode/tootpress)

tootpress_blog.php

@@ -209,4 +209,25 @@ function tootpress_paint_closing($tootpress_current_page) {
 
 }
 
+/**
+ * Create the Before Loop Content.
+ * 
+ * @since 0.5
+ * 
+ * @param int TootPress Current Page
+ * @return string Content
+ */
+
+function tootpress_paint_beforeloop($tootpress_current_page) {
+
+	$content=tootpress_beforeloop_filter_apply($tootpress_current_page);
+
+	if($content) {
+		$content='<div class="tootpress-beforeloop">'.$content.'</div>';
+	}
+
+	return $content;
+
+}
+
 ?>

tootpress_hooks.php

@@ -184,5 +184,44 @@ function tootpress_menu_backward_filter_apply($label) {
  *  add_filter( 'tootpress_menu_backward_label', 'tootpress_menu_backward_label_change', 10, 1 );
  *
  */
- 
+
+/**
+ * Before Loop Filter
+ * 
+ * This filter outputs content before the toot loop.
+ * It will be applied on all tootpress pages.
+ * 
+ * @since 0.5
+ * 
+ * @param int TootPress Page Number
+ * @return string Content
+ */
+
+function tootpress_beforeloop_filter_apply($page_number) {
+
+	$content='';
+
+	$content=apply_filters( 'tootpress_beforeloop_filter', $content, $page_number );
+
+	return $content;
+}
+
+/**
+ * Usage Example: tootpress_beforeloop_filter
+ * 
+ * @param string Content (empty)
+ * @param int TootPress Page Number
+ * @return string Content (filtered)
+ *
+ * function tootpress_beforeloop_filter_add( $content, $page_number ) {
+ * 
+ * 		// Add your filter code here
+ * 		// Example: $content='<p>Page '.$page_number.'</p>';
+ * 
+ * 		return $content;
+ *
+ * }
+ * add_filter( 'tootpress_beforeloop_filter', 'tootpress_beforeloop_filter_add', 10, 2 );
+ */
+
 ?>

tootpress_loop.php

@@ -35,10 +35,13 @@ function tootpress_content($content) {
         // TootPress Preamble
         $tootpress_content.=tootpress_paint_preamble($tootpress_current_page);
 
+        // TootPress Before Loop
+        $tootpress_content.=tootpress_paint_beforeloop($tootpress_current_page);
+
         // TootPress Loop
         $tootpress_content.=tootpress_loop($tootpress_current_page);
 
-        // TootPress Afterloop
+        // TootPress Closing
         $tootpress_content.=tootpress_paint_closing($tootpress_current_page);
 
         // TootPress Bottom Navigation