Title: TW Pagination
Author: tweetysha
Published: <strong>21 Nofeembar, 2012</strong>
Last modified: 31 Maarso, 2015

---

Raadi kaabayaal

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/tw-pagination.svg)

# TW Pagination

 Qore [tweetysha](https://profiles.wordpress.org/tweetysha/)

[Soo Rog](https://downloads.wordpress.org/plugin/tw-pagination.zip)

 * [Faahfaahin](https://so.wordpress.org/plugins/tw-pagination/#description)
 * [Dibu-eegisyo](https://so.wordpress.org/plugins/tw-pagination/#reviews)
 *  [Rakibaad](https://so.wordpress.org/plugins/tw-pagination/#installation)
 * [Horumarinta](https://so.wordpress.org/plugins/tw-pagination/#developers)

 [Taageero](https://wordpress.org/support/plugin/tw-pagination/)

## Sharraxaad

TW Pagination is a simple and flexible pagination plugin which provides users with
better navigation on your WordPress site.

In addition to increasing the user experience for your visitors, it has also been
widely reported that pagination increases the SEO of your site by providing more
links to your content.

TW Pagination can also be used to paginate post comments!

## Rakibaad

_Install and Activate_

 1. Unzip the downloaded `tw-pagination` zip file
 2. Upload the `tw-pagination` folder and its contents into the `wp-content/plugins/`
    directory of your WordPress installation
 3. Activate TW Pagination from Plugins page

_Implement_

For posts pagination:

1) Open the theme files where you’d like pagination to be used. Usually this is 
the `loop.php` file. For older version of WordPress, you may need to update the `
index.php`, `archive.php` and `search.php` files.

2) Replace your existing `previous_posts_link()` and `next_posts_link()` code block
with the following:

    ```
    <?php if(function_exists('tw_pagination')) 
        tw_pagination();
    ?>
    ```

For comments pagination:

1) Open the theme file(s) where you’d like comments pagination to be used. Usually
this is the `comments.php` file.

2) Replace your existing `previous_comments_link()` and `next_comments_link()` code
block with the following:

    ```
    <?php if(function_exists('tw_pagination_comments')) 
        tw_pagination_comments();
    ?>
    ```

_Configure_

1) Configure the TW Pagination settings, if necessary, from the TW Pagination option
in the Settings menu

2) The styles can be changed with the following methods:

 * Add a `tw-pagination.css` file in your theme’s directory and place your custom
   CSS there
 * Add your custom CSS to your theme’s `styles.css`
 * Modify the `tw-pagination.css` file in the tw-pagination plugin directory

_Note:_ The first two options will ensure that TW Pagination updates will not overwrite
your custom styles.

## SBI

  How can I override the default pagination settings?

The `tw_pagination()` and `tw_pagination_comments()` functions each takes two optional
arguments.
 Second argument is in query string format, which allows you to override
the global settings. The available options are:

 * title – The text/HTML to display before the pagination links
 * nextpage – The text/HTML to use for the next page link
 * previouspage – The text/HTML to use for the previous page link
 * before – The text/HTML to add before the pagination links
 * after – The text/HTML to add after the pagination links
 * empty – Display before markup and after markup code even when the page list is
   empty
 * range – The number of page links to show before and after the current page
 * anchor – The number of links to always show at beginning and end of pagination
 * gap – The minimum number of pages before a gap is replaced with an ellipsis (…)

You can even control the current page and number of pages with:

 * page – The current page. This function will automatically determine the value
 * pages – The total number of pages. This function will automatically determine
   the value

Examples (also applies to `tw_pagination_comments()`):

1) To paginate custom WP_Query:

    ```
    <?php 
        $the_query = new WP_Query( $args ); 
        while($the_query->have_posts()) : $the_query->the_post();
        // your code
        endwhile;

        if(function_exists('tw_pagination')) 
            tw_pagination($the_query, 'range=4&anchor=2&nextpage=Next&previouspage=Previous');
    ?>
    ```

2) To paginate default WP_Query with custom settings

    ```
    <?php if(function_exists('tw_pagination')) 
        tw_pagination('global', 'range=4&anchor=2&nextpage=Next&previouspage=Previous');
    ?>
    ```

3) To paginate default WP_Query

    ```
    <?php if(function_exists('tw_pagination')) 
        tw_pagination();
    ?>
    ```

  How can I style the comments pagination differently than the posts pagination?

When calling `tw_pagination_comments()`, TW Pagination adds an extra class to the`
ol` element, `tw-pagination-comments`.

This allows you to use the `.tw-pagination-comments` styles, already in `tw-pagination.
css`, to override the default styles.

## Dibu-eegisyo

Ma jiraan wax dibu-eegis ah oo ku saabsan kaabahan.

## Ka-qaybgalayaasha & Horumariyayaasha

“TW Pagination” waa softiweer il furan. Dadka soo socda ayaa wax ku biiriyay kaabahan.

Ka-qaybgalayaasha

 *   [ tweetysha ](https://profiles.wordpress.org/tweetysha/)

[Ku tarjun “TW Pagination” luqaddaada.](https://translate.wordpress.org/projects/wp-plugins/tw-pagination)

### Ma xiisaynaysaa horumarinta?

[Baadh koodka](https://plugins.trac.wordpress.org/browser/tw-pagination/), fiiri
[bakhaarka SVN](https://plugins.svn.wordpress.org/tw-pagination/), ama iska qor 
[diiwaanka horumarinta](https://plugins.trac.wordpress.org/log/tw-pagination/) adigoo
adeegsanaya [RSS](https://plugins.trac.wordpress.org/log/tw-pagination/?limit=100&mode=stop_on_copy&format=rss).

## Isbeddellada

#### 1.1

 * Removed PHP4 constructor
 * Code improvements

#### 1.0

 * Initial release

## Meta

 *  Version **1.1**
 *  Last updated **11 sano kahor**
 *  Active installations **1,000+**
 *  WordPress version ** 3.0 ama ka sareeya **
 *  Tested up to **4.1.42**
 *  Language
 * [English (US)](https://wordpress.org/plugins/tw-pagination/)
 * Tags
 * [navigation](https://so.wordpress.org/plugins/tags/navigation/)[page](https://so.wordpress.org/plugins/tags/page/)
   [Paginate](https://so.wordpress.org/plugins/tags/paginate/)[pagination](https://so.wordpress.org/plugins/tags/pagination/)
 *  [Aragti Sare](https://so.wordpress.org/plugins/tw-pagination/advanced/)

## Qiimeynta

 5 out of 5 stars.

 *  [  7 5-star reviews     ](https://wordpress.org/support/plugin/tw-pagination/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/tw-pagination/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/tw-pagination/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/tw-pagination/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/tw-pagination/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/tw-pagination/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/tw-pagination/reviews/)

## Ka-qaybgalayaasha

 *   [ tweetysha ](https://profiles.wordpress.org/tweetysha/)

## Taageero

Ma heysaa waxaad dhahdo? Caawimaad ma u baahan tahay?

 [Eeg madasha taageerada](https://wordpress.org/support/plugin/tw-pagination/)