Changeset 2097

Timestamp:

02/21/2008 11:02:24 AM (8 months ago)

Author:

Geert

Message:

• Pagination API change: create_links() has been renamed to render(). It is shorter, more consistent and also describes better what the method actually does.
  
• Implemented #419: auto_hide option. Setting it to TRUE will hide all pagination stuff if there are only 1 or 0 pages in total.
  

Location:

trunk

Files:

• application/controllers/examples.php (modified) (1 diff)
• system/libraries/Pagination.php (modified) (3 diffs)

trunk/application/controllers/examples.php

@@ -261 +261 @@
                 echo 'Classic style: '.$pagination;
 
-                // You can also use the create_links() method and pick a style on the fly if you want
-                echo '<hr />Digg style:     '.$pagination->create_links('digg');
-                echo '<hr />Extended style: '.$pagination->create_links('extended');
-                echo '<hr />PunBB style:    '.$pagination->create_links('punbb');
+                // You can also use the render() method and pick a style on the fly if you want
+                echo '<hr />Digg style:     '.$pagination->render('digg');
+                echo '<hr />Extended style: '.$pagination->render('extended');
+                echo '<hr />PunBB style:    '.$pagination->render('punbb');
                 echo 'done in {execution_time} seconds';
         }

trunk/system/libraries/Pagination.php

@@ -19 +19 @@
         protected $items_per_page = 10;
         protected $total_items    = 0;
+        protected $auto_hide      = FALSE;
 
         // Automatically generated values
@@ -117 +118 @@
          * @return  string  pagination html
          */
-        public function create_links($style = NULL)
+        public function render($style = NULL)
         {
-                $style = (isset($style)) ? $style : $this->style;
-                $view = new View($this->directory.$style, get_object_vars($this));
-                return $view->render();
+                // Hide single page pagination
+                if ($this->auto_hide == TRUE AND $this->total_pages <= 1)
+                        return '';
+
+                if ($style === NULL)
+                {
+                        // Use default style
+                        $style = $this->style;
+                }
+
+                // Return rendered pagination view
+                return View::factory($this->directory.$style, get_object_vars($this))->render();
         }
 
@@ -131 +141 @@
         public function __toString()
         {
-                return $this->create_links();
+                return $this->render();
         }