WordPress.org

فارسی

دریافت وردپرس
WordPress.org

Plugin Directory

PDFGate – HTML to PDF

PDFGate – HTML to PDF

توسط PDFGate
دانلود

توضیحات

PDFGate turns any post, page or custom post type into a PDF with one click. The rendering happens on the PDFGate API using a headless Chromium engine, so what your visitors download matches what they see on screen: web fonts, CSS grid, background images, embedded charts and all.

Features

  • “Download as PDF” block for the block editor, with a custom label and alignment.
  • [pdfgate_download] shortcode for classic themes and page builders.
  • Optionally add the button automatically below every post, page or custom post type.
  • Two render modes: the public page as your theme shows it, or the post content alone with a clean print template.
  • Page size, orientation, margins, print media emulation, background printing and image loading settings.
  • Global header and footer HTML with page numbers, date, title and URL placeholders.
  • Optional fillable form fields: HTML inputs on the page become interactive PDF fields.
  • Generated PDFs are cached and reused until the post changes, so your API quota is spent once per edit, not once per visitor.
  • Per-visitor rate limiting protects your quota from bots.
  • API key stored encrypted. It can also be defined as the PDFGATE_API_KEY constant in wp-config.php.
  • Filters for developers to change the request, the template, the filename and the button markup.

Requirements

A free PDFGate account and API key from pdfgate.com. The free plan includes a monthly allowance of PDF generations; paid plans increase it.

External service

This plugin sends content to the PDFGate API (https://api.pdfgate.com, or https://api-sandbox.pdfgate.com for test keys) to render PDFs. Nothing is sent until a visitor requests a PDF or an administrator runs the connection test.

Depending on the render mode, the request contains either the public URL of the post or the rendered HTML of the post content, together with your API key and the site URL. PDFGate processes the request to produce the PDF and keeps a request log for billing and abuse prevention. Documents are only stored on PDFGate servers if storage is enabled in your PDFGate account settings.

عکس‌های صفحه

The "Download as PDF" block in the editor.
The “Download as PDF” block in the editor.
The settings screen.
The settings screen.
A generated PDF next to the original page.
A generated PDF next to the original page.

بلوک‌ها

این افزونه 1 بلوک ارائه می‌دهد.

  • Download as PDF A button that downloads the current post or page as a PDF rendered by PDFGate.

نصب

  1. Install and activate the plugin.
  2. Create an API key at https://dashboard.pdfgate.com/settings/api-keys.
  3. Go to Settings PDFGate, paste the key and click “Test connection”.
  4. Add the “Download as PDF” block to a post, use the [pdfgate_download] shortcode, or enable “Add automatically” for your post types.

سوالات متداول

Does this work on a local or password-protected site?

The “Public page URL” render mode needs PDFGate to fetch your page, so the site must be reachable from the internet and the post must be public. Switch to “Post content” mode for local development, staging sites behind a login, or drafts.

How do I hide an element from the PDF?

In URL mode, add the CSS class pdfgate-hide to any element, or target the pdfgate-render body class in your stylesheet. The download button itself is always hidden.

How many API requests does a download use?

One per post per edit. The generated file is cached in wp-content/uploads/pdfgate and served from there until the post is updated, the settings change, or a day passes. Visitors are also limited to ten fresh generations per minute. Developers can change both with the pdfgate_cache_ttl and pdfgate_rate_limit filters.

Can I add a header or footer, or change any other option?

Yes. Use the pdfgate_generate_payload filter to set any option documented at https://pdfgate.com/documentation/generate-pdf, for example header, footer, css or javascript.

Where is the API key stored?

Encrypted in the WordPress options table, using a key derived from your site’s authentication salts. You can instead define PDFGATE_API_KEY in wp-config.php, in which case the settings page becomes read-only for the key.

نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

توسعه دهندگان و همکاران

“PDFGate – HTML to PDF” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

مشارکت کنندگان

ترجمه “PDFGate – HTML to PDF” به زبان شما.

علاقه‌ مند به توسعه هستید؟

کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.

گزارش تغییرات

1.0.0

  • Initial release: block, shortcode, automatic button, URL and content render modes, caching and rate limiting.

اطلاعات

امتیازها

هنوز هیچ نقدی ارسال نشده است.

بررسی شما

مشاهدهٔ همهٔ بررسی‌ها

مشارکت کنندگان

پشتیبانی

چیزی برای گفتن دارید؟ نیاز به کمک دارید؟

مشاهده انجمن پشتیبانی