Django PDF Actions¶

**A powerful Django application for generating PDF exports from the Django admin interface**

🚀 Overview¶

Transform your Django admin interface into a powerful PDF export engine! Django PDF Actions seamlessly integrates professional PDF generation capabilities into your existing Django models with minimal configuration.

graph LR
    A[Django Admin] --> B[Select Records]
    B --> C[Choose Export Action]
    C --> D[PDF Generation]
    D --> E[Download PDF]

    style A fill:#e1f5fe
    style E fill:#c8e6c9

✨ Key Features¶

actions = [export_to_pdf_landscape, export_to_pdf_portrait]

🏃‍♂️ Quick Start¶

Get up and running in 60 seconds:

# 1. Install the package
pip install django-pdf-actions

# 2. Add to your settings
INSTALLED_APPS = [
    # ...
    'django_pdf_actions',
]

# 3. Run migrations
python manage.py migrate

# 4. Add to your admin.py
from django_pdf_actions.actions import export_to_pdf_landscape, export_to_pdf_portrait

@admin.register(YourModel)
class YourModelAdmin(admin.ModelAdmin):
    list_display = ('name', 'email', 'created_at')
    actions = [export_to_pdf_landscape, export_to_pdf_portrait]

🔄 How It Works¶

sequenceDiagram
    participant U as User
    participant A as Django Admin
    participant P as PDF Actions
    participant R as ReportLab
    participant F as File System

    U->>A: Select records
    U->>A: Choose PDF export action
    A->>P: Process export request
    P->>P: Get model data & settings
    P->>R: Generate PDF document
    R->>F: Create PDF file
    F->>U: Download PDF

🌍 Internationalization Support¶

Perfect for global applications with built-in RTL support:

graph TD
    A[Multi-language Content] --> B{Text Direction}
    B -->|LTR| C[English, French, German...]
    B -->|RTL| D[Arabic, Persian, ...]
    C --> E[Left-aligned Layout]
    D --> F[Right-aligned Layout]
    E --> G[Professional PDF Output]
    F --> G

    style A fill:#fff3e0
    style G fill:#e8f5e8

📊 Use Cases¶

🎯 Perfect For¶

• Businesses needing professional document generation
• Developers wanting quick PDF export functionality
• Multi-language applications requiring RTL support
• Large datasets requiring optimized performance

🛠️ Technical Specifications¶

📚 Documentation Structure¶

mindmap
  root((Documentation))
    Getting Started
      Installation
      Quick Start
      Basic Usage
    Configuration
      Settings
      Advanced Config
    Examples
      Real-world Cases
      Custom Methods
    API Reference
      Actions
      Models
      Utils

🤝 Community & Support¶

• 💬 GitHub Discussions
• 🐛 Issue Tracker
• 📖 Documentation
• 📦 PyPI Package

📄 License¶

This project is licensed under the MIT License - see the LICENSE file for details.