Skip to content

Settings Reference

Django PDF Actions Logo

Configuration Guide

PDF Export Settings

Page Layout Settings

Page Size

  • Description: Select the size of the PDF pages
  • Default: A4
  • Options:
  • A4 (210mm × 297mm)
  • A3 (297mm × 420mm)
  • A2 (420mm × 594mm)
  • A1 (594mm × 841mm)
  • Impact: Affects the available space for content, number of rows per page, and overall document dimensions

Items Per Page

  • Description: Number of items to display per page
  • Default: 10
  • Range: 1-50
  • Note: The actual number of items that fit may vary based on content and selected page size

Django PDF Export provides a comprehensive set of settings that can be configured through the Django admin interface.

Page Layout Settings

Setting Description Default Range
items_per_page Number of rows per page 10 1-50
page_margin_mm Page margins in millimeters 15 5-50
header_height_mm Header height in millimeters 20 10-50
footer_height_mm Footer height in millimeters 15 10-50

Font Settings

Setting Description Default Range
font_name TTF font file name DejaVuSans.ttf Any TTF
header_font_size Header text size 10 6-24
body_font_size Body text size 7 6-18

Table Settings

Setting Description Default Range
table_spacing Cell padding in millimeters 1.5 0.5-5.0
table_line_height Row height multiplier 1.2 1.0-2.0
table_header_height Header row height 30 20-50
max_chars_per_line Maximum characters per line 50 30-100

Visual Settings

Setting Description Default
header_background_color Header background color #F0F0F0
grid_line_color Table grid line color #000000
grid_line_width Grid line thickness 0.25

Display Options

Setting Description Default
show_header Display page header True
show_logo Display company logo True
show_export_time Show export timestamp True
show_page_numbers Show page numbers True
rtl_support Enable right-to-left text support False

Text Alignment Options

Setting Description Default Options
title_alignment Alignment for document title CENTER LEFT, CENTER, RIGHT
header_alignment Alignment for table headers CENTER LEFT, CENTER, RIGHT
content_alignment Alignment for table content CENTER LEFT, CENTER, RIGHT

RTL Support

Django PDF Actions provides comprehensive support for right-to-left languages like Arabic and Persian.

Features:

  • Automatic text reshaping for proper RTL script display
  • Reversal of column ordering to match RTL reading direction
  • Proper bidirectional text handling
  • RTL-appropriate alignment options

To enable RTL support: 1. Navigate to Admin > Django PDF > Export PDF Settings 2. Enable the "RTL Support" option 3. Select appropriate alignment options for your content 4. Use fonts that support your target language (e.g., Cairo for Arabic)

Configuration Example

Here's an example of how to configure the settings through the Django admin interface:

  1. Navigate to Admin > Django PDF > Export PDF Settings
  2. Click "Add Export PDF Settings"
  3. Configure your settings: 
    {
    'title': 'Default Export Settings',
    'active': True,
    'header_font_size': 12,
    'body_font_size': 8,
    'page_margin_mm': 20,
    'items_per_page': 15,
    'table_spacing': 2.0,
    'show_logo': True,
    'show_page_numbers': True
}
  4. Save your settings

Notes

  • Only one configuration can be active at a time
  • Changes take effect immediately
  • Font files must be in the correct directory
  • Colors should be in hexadecimal format (#RRGGBB)