README

SmartPagination is a Laravel Blade component that simplifies pagination rendering and adds support for reverse pagination (descending page numbers). It’s designed to be flexible, SEO-friendly, and easy to customize.

Designed for blogs, news feeds, and any content that grows over time.

Features

• Stable URLs — older content stays on the same page even as new items are added
• SEO-Friendly — search engines retain indexing without shifting links
• User-Centric — newest content always appears on the first page
• Blade component - easy to use in Blade templates with Bootstrap-ready markup
• Flexible Routing - supports custom URL patterns via page-pattern
• Preserves all other query parameters
• Reverse pagination support - show newest content first

🌐 SEO-Friendly Pagination with Custom URL Patterns

SmartPagination allows you to generate clean, customizable, and SEO-optimized pagination URLs for your applications. Instead of relying on default query parameters like ?page=2, you can define your own URL patterns such as /blog/page-2, /news-p3.html, or even /archive-4y.html.

✅ Why It Matters for SEO

Search engines prefer stable, predictable URLs. When paginated content (like blog posts, product listings, or news articles) grows over time, traditional pagination can cause older content to shift across pages — which may lead to:

• Duplicate indexing
• Loss of link equity
• Lower rankings for older content

With reverse pagination and custom URL patterns, you can ensure that:

• The first page always shows the newest content
• Older content remains accessible at the same URL
• Search engines consistently index the same pages over time

This improves crawl efficiency and preserves ranking signals for evergreen content.

🔧 Examples of Custom Patterns

You can define your own pagePattern using {page} as a placeholder:

🔁 Reverse Pagination: Keep Your URLs Stable as Content Grows

Reverse pagination is a powerful feature that ensures your newest content always appears on the first page, while older content stays anchored to its original URLs. This is especially useful for blogs, news feeds, changelogs, or any time-sensitive content.

With reverse pagination, the first page always shows the latest items, and older pages remain unchanged — making your site more SEO-friendly.

🔧 Examples of Reverse Pagination

You have 100 articles, sorted by newest first (DESC), showing 10 per page.

🔴 With Reverse Pagination Disabled

Tomorrow you publish 10 more articles (total: 110):

✅ With Reverse Pagination Enabled

Result:

• New content appears on the first page
• Older content stays at the same URL
• Search engines retain stable indexing
• No shifting of articles across pages

Installation

Install via Composer:

composer require wnikk/smart-pagination

Usage

For basic usage, you can use the smartPaginate method on your Eloquent model. This method will automatically handle pagination with the latest items first and generate reverse pagination links.

For example, if you have a Post model and want to paginate the latest posts on controller:

$posts = \App\Models\Post::orderByDesc('created_at')->smartPaginate(10, reverse: true);
$posts->withPath('/post', '/page-{page}.html'); 

In your Blade view (by default):

By default:
{{ $posts->links() }}

Or your Blade custom view full version of params (SEO-friendly):

<x-smart-pagination 
    :paginator="$posts" 
    :reverse="true"
    :page-pattern="post-p{page}.html"
    :show-prev-next="true"
/>

Publish Configuration (optional)

Publish Configuration

php artisan vendor:publish --tag=smart-pagination-config

Publish Blade Views

php artisan vendor:publish --tag=smart-pagination-views

License

MIT