docs: improve sample code and description

Author: kenjis

user_guide_src/source/libraries/pagination.rst

@@ -46,15 +46,27 @@ To customize a query for pagination in a model, you can add
 :doc:`Query Builder <../database/query_builder>` methods before ``paginate()``
 method.
 
-To add WHERE conditions:
+Adding WHERE
+------------
+
+If you want to add WHERE conditions, you can specify conditions directly:
 
 .. literalinclude:: pagination/003.php
     :lines: 2-
 
+You can move the conditions to a separate method:
+
+.. literalinclude:: pagination/017.php
+
+.. literalinclude:: pagination/018.php
+    :lines: 2-
+
+Adding JOIN
+-----------
+
 You can join another table:
 
 .. literalinclude:: pagination/016.php
-    :lines: 2-
 
 .. important:: It is important to understand that the ``Model::paginate()`` method
     uses the **Model** and the **Query Builder** instance in the Model.

user_guide_src/source/libraries/pagination/003.php

@@ -1,27 +1,9 @@
 <?php
 
-// You can specify conditions directly.
+// In your Controller.
 $model = new \App\Models\UserModel();
 
 $data = [
     'users' => $model->where('ban', 1)->paginate(10),
     'pager' => $model->pager,
 ];
-
-// You can move the conditions to a separate method.
-class UserModel extends Model
-{
-    // ...
-
-    public function banned()
-    {
-        $this->builder()->where('ban', 1);
-
-        return $this; // This will allow the call chain to be used.
-    }
-}
-
-$data = [
-    'users' => $model->banned()->paginate(10),
-    'pager' => $model->pager,
-];

user_guide_src/source/libraries/pagination/016.php

@@ -1,5 +1,9 @@
 <?php
 
+namespace App\Models;
+
+use CodeIgniter\Model;
+
 class NewsModel extends Model
 {
     protected $table = 'news';

user_guide_src/source/libraries/pagination/017.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace App\Models;
+
+use CodeIgniter\Model;
+
+class UserModel extends Model
+{
+    // ...
+
+    public function banned()
+    {
+        $this->builder()->where('ban', 1);
+
+        return $this; // This will allow the call chain to be used.
+    }
+}

user_guide_src/source/libraries/pagination/018.php

@@ -0,0 +1,9 @@
+<?php
+
+// In your Controller.
+$model = new \App\Models\UserModel();
+
+$data = [
+    'users' => $model->banned()->paginate(10),
+    'pager' => $model->pager,
+];