django-admin-recent-inlines 0.1.5

Recent inlines with view-all functionality

Django Admin Recent Inlines

A Django package that provides a RecentTabularInline class for displaying recent related objects in Django admin with a "View All" link.

Features

• Recent Inlines: Display only the most recent related objects in Django admin
• View All Link: Automatically adds a "View All" link when there are more objects than the display limit
• Configurable Limit: Set the maximum number of related objects to display
• Django Admin Integration: Seamlessly integrates with Django's admin interface

Installation

pip install django-admin-recent-inlines

Development Installation

If you're installing from source for development:

git clone https://github.com/AugendLimited/django-admin-recent-inlines.git
cd django-admin-recent-inlines
pip install -e .

Then add to your Django settings:

INSTALLED_APPS = [
    # ... your other apps
    'django_admin_recent_inlines',
]

Usage

Basic Usage

from django.contrib import admin
from django_admin_recent_inlines.admin import RecentTabularInline
from .models import ParentModel, ChildModel

class ChildInline(RecentTabularInline):
    model = ChildModel
    maximum_number_of_related_rows_to_display = 5  # Show only 5 most recent

@admin.register(ParentModel)
class ParentAdmin(admin.ModelAdmin):
    inlines = [ChildInline]

Configuration Options

• maximum_number_of_related_rows_to_display: Number of recent objects to display (default: 5)
• template: Custom template for the inline (default: uses the provided template)
• All standard TabularInline options are supported

Performance Optimization

The package automatically caches queryset results to prevent duplicate database queries. For additional performance improvements with related objects, override the optimize_queryset method:

class ChildInline(RecentTabularInline):
    model = ChildModel
    maximum_number_of_related_rows_to_display = 5
    
    def optimize_queryset(self, queryset):
        # Use select_related for foreign keys
        return queryset.select_related('currency', 'category')
        
        # Or use prefetch_related for many-to-many relationships
        # return queryset.prefetch_related('tags', 'related_items')

This prevents N+1 query problems when displaying related objects in the inline.

How It Works

1. The RecentTabularInline limits the queryset to show only the most recent related objects
2. Queryset results are cached to prevent duplicate database queries during rendering
3. When there are more objects than the display limit, a "View All" link is automatically added
4. The "View All" link takes you to the filtered changelist view showing all related objects
5. The link includes the count of total related objects

Requirements

• Python 3.11+
• Django 4.0+

Development

Setup

git clone https://github.com/AugendLimited/django-admin-recent-inlines.git
cd django-admin-recent-inlines
poetry install

Running Tests

poetry run pytest

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.