PHPackages nowo-tech/pdf-signable-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [PDF & Document Generation](/categories/documents) 4. / 5. nowo-tech/pdf-signable-bundle ActiveSymfony-bundle[PDF & Document Generation](/categories/documents) nowo-tech/pdf-signable-bundle ============================= Define signature box coordinates on PDFs in Symfony: form type with PDF.js viewer, drag-and-drop placement, validation, and signing hooks. v2.0.4(2mo ago)0583↓46.9%[4 PRs](https://github.com/nowo-tech/PdfSignableBundle/pulls)MITPHPPHP >=8.1CI failing Since Feb 9Pushed 1mo agoCompare [ Source](https://github.com/nowo-tech/PdfSignableBundle)[ Packagist](https://packagist.org/packages/nowo-tech/pdf-signable-bundle)[ Docs](https://github.com/nowo-tech/pdfSignableBundle)[ RSS](/packages/nowo-tech-pdf-signable-bundle/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (20)Versions (20)Used By (0) PdfSignable Bundle ================== [](#pdfsignable-bundle) [![CI](https://github.com/nowo-tech/PdfSignableBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/PdfSignableBundle/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/d53327fca8ff402c838ee315044d47b29086805592fe9a23d5a2dd0c5a8a7af6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f7064662d7369676e61626c652d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/pdf-signable-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/ed2a6fdc1b9e9e21d308ca4d50e03e12c4ea7b85d60e8e1c94310f062b03674f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f7064662d7369676e61626c652d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/pdf-signable-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/8e58b490725ac49cc8e463c473173681b324c9d92d7854275a785db013ca3de7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/71fcd26d8ba51b55b3881a7adb433250b257eaf74ebaaeca9965db5bdd1646ac/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d362e3125324225323025374325323037253230253743253230382d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/c9376e8df6aa69df9885784c1c54b4643810ec530d7ad5af116c2ccaf5365257/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f7064662d7369676e61626c652d62756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/PdfSignableBundle) [![Coverage](https://camo.githubusercontent.com/cd0704b56f1d56def350b6d0164316307bb2f47834225fd85443b6fb0059bc73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352d627269676874677265656e)](#tests-and-coverage) > ⭐ **Found this useful?** [Install from Packagist](https://packagist.org/packages/nowo-tech/pdf-signable-bundle) Β· Give it a star on [GitHub](https://github.com/nowo-tech/PdfSignableBundle) to help others find it. **Symfony bundle to define signature box coordinates on PDFs.** Form type with an in-browser PDF.js viewer: users place and resize signature areas by clicking and dragging. Supports units (mm, cm, pt), validation, proxy for external PDFs, and hooks for PKI/timestamp/batch signing. Symfony 6.1+, 7.x, 8.x Β· PHP 8.1+. What is this? ------------- [](#what-is-this) This bundle helps you **define signature box coordinates on PDFs** in your Symfony applications for: - πŸ“„ **PDF signature placement** β€” Let users visually place and resize signature areas on a PDF - πŸ“ **Units and origin** β€” Work in mm, cm, pt, px or in; choose coordinate origin (e.g. bottom-left) - πŸ”— **External PDFs** β€” Optional proxy to load external PDFs without CORS issues - βš™οΈ **Named configs** β€” Reuse presets (fixed URL, units, limits) via `config: 'name'` in YAML - βœ… **Validation** β€” Required box names, unique names per form, min/max entries - 🎯 **Events** β€” Hook into proxy request/response and coordinate submission for custom logic Quick Search Terms ------------------ [](#quick-search-terms) Looking for: **PDF signature coordinates**, **signature box placement**, **PDF.js Symfony**, **PDF form coordinates**, **signature position configurator**, **Symfony PDF viewer**, **signature overlay**, **PDF signing workflow**, **coordinate picker**, **document signing**? You've found the right bundle! Features -------- [](#features) - βœ… **Form type** β€” `SignatureCoordinatesType` with PDF URL, units (mm, cm, pt, px, in), coordinate origin (corners) and collection of signature boxes - βœ… **PDF viewer** β€” In-browser viewer (PDF.js) with overlays for each box; click to add, drag to move, drag corners to resize - βœ… **Optional proxy** β€” Load external PDFs without CORS; configurable via `nowo_pdf_signable.proxy_enabled` - βœ… **Named configurations** β€” Define presets in `nowo_pdf_signable.signature.configs` (or `acroform.configs`) and use `config: 'alias'` when adding the form type - βœ… **URL modes** β€” Free-text URL input or dropdown choice (`url_mode: choice`, `url_choices`) - βœ… **Box options** β€” Name as text or dropdown (`name_mode: choice`); min/max entries; optional **unique box names** validation; **page restriction** (`allowed_pages`); **sort order** on submit (`sort_boxes`); **no overlapping boxes** (`prevent_box_overlap`, default true); **minimum box size** (`min_box_width`, `min_box_height`); **optional rotation** (`enable_rotation`); **default values per name** (`box_defaults_by_name`); **snap to grid** (`snap_to_grid`) and **snap to other boxes** (`snap_to_boxes`, default true); **guides and grid** (`show_grid`, `grid_step`); **viewer lazy load** (`viewer_lazy_load`); **batch signing** (`batch_sign_enabled`, β€œSign all” button). **Audit**: optional fill from request (`audit.fill_from_request`), placeholders for TSA and signing service (see [SIGNING\_ADVANCED](docs/SIGNING_ADVANCED.md)) - βœ… **Viewer** β€” **Thumbnails**: page strip to jump to a page; **Zoom**: toolbar (zoom in, zoom out, fit width, translated); **Touch**: pinch to zoom, two-finger pan on tablets - βœ… **Validation** β€” Required box name (NotBlank); `unique_box_names` global (`true`/`false`) or per-name (array) to enforce unique box names - βœ… **Events** β€” `PdfProxyRequestEvent`, `PdfProxyResponseEvent`, `SignatureCoordinatesSubmittedEvent`, `BatchSignRequestedEvent`, `PdfSignRequestEvent` for integration (see [EVENTS](docs/EVENTS.md) and [SIGNING\_ADVANCED](docs/SIGNING_ADVANCED.md)) - βœ… **Compatibility** β€” Symfony 6.1+, 7.x, 8.x and PHP 8.1+ Screenshots ----------- [](#screenshots) **Demo index** β€” Each card shows a different way to configure `SignatureCoordinatesType` (named configs, URL options, box validation, model prefill): [![Demo home β€” configuration overview](docs/img/demo-home.png)](docs/img/demo-home.png) **Signature coordinates form** β€” PDF viewer with draggable signature boxes; unit/origin selector and box list on the right: [![Signature coordinates form β€” PDF viewer and boxes](docs/img/demo-signature-form.png)](docs/img/demo-signature-form.png) **Signature form (alternate view)** β€” Same form with thumbnails strip, zoom toolbar and optional rotation; boxes can be placed flush to page edges at any angle: [![Signature form β€” thumbnails, zoom and rotation](docs/img/demo-signature-form-2.png)](docs/img/demo-signature-form-2.png) Installation ------------ [](#installation) ``` composer require nowo-tech/pdf-signable-bundle ``` [Symfony Flex](https://symfony.com/doc/current/setup/flex.html) registers the bundle automatically. Otherwise see [Installation](docs/INSTALLATION.md) to register the bundle and routes. **Unreleased / dev:** To use the latest default branch (`main` or `master`), add the VCS repo and require `dev-main` or `dev-master` β€” see [docs/INSTALLATION.md](docs/INSTALLATION.md). Quick Start ----------- [](#quick-start) 1. **Add the form type** to your form (or use the default route `/pdf-signable`): ``` use Nowo\PdfSignableBundle\Form\SignatureCoordinatesType; use Nowo\PdfSignableBundle\Model\SignatureCoordinatesModel; $model = new SignatureCoordinatesModel(); $form = $this->createForm(SignatureCoordinatesType::class, $model); // Or use a named config: ['config' => 'fixed_url'] ``` 2. **Render the form** with the bundle form theme so the PDF viewer and boxes render correctly: ``` {% form_theme form '@NowoPdfSignable/form/theme.html.twig' %} {{ form_widget(form.signatureCoordinates) }} ``` 3. **On submit** you get a `SignatureCoordinatesModel` with `pdfUrl`, `unit`, `origin` and `signatureBoxes` (each with name, page, x, y, width, height, and angle when `enable_rotation` is true). Configure `nowo_pdf_signable` (proxy, example URL, optional [named configs](docs/CONFIGURATION.md)) as needed. See [Usage](docs/USAGE.md) for full options and examples. Requirements ------------ [](#requirements) - PHP >= 8.1 - **Symfony >= 6.1** || >= 7.0 || >= 8.0 - PHP extensions required by Symfony (e.g. json, mbstring, ctype, xml, fileinfo). **Optional:** `ext-yaml` for faster YAML config parsing (see `composer suggest`) Configuration ------------- [](#configuration) The bundle works with default settings. Create or edit `config/packages/nowo_pdf_signable.yaml`: ``` nowo_pdf_signable: proxy_enabled: true # Proxy route for external PDFs (avoids CORS) # example_pdf_url: bundle default is a sample public PDF URL; set to '' to disable preload # debug: false # Browser console logging for the viewer (default false) signature: configs: {} # Named presets; see CONFIGURATION.md ``` See [CONFIGURATION.md](docs/CONFIGURATION.md) for the full tree (`proxy_url_allowlist`, `audit`, `tsa_url`, `signing_service_id`, `acroform.*`, etc.) and default values. Demos ----- [](#demos) Dockerized demos (Symfony 7 and 8, Bootstrap, Vite, TypeScript) with multiple usage examples. They run with **FrankenPHP** (Caddy + PHP): the **Dockerfile** ships a production Caddyfile with **`php_server` worker**, but with **`APP_ENV=dev`** the container **entrypoint swaps in `Caddyfile.dev`** (no worker, cache-busting headers) so local dev matches [docs/DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md). Served over **HTTPS** on localhost (self-signed certificate; accept it in the browser). The [screenshots above](#screenshots) show the demo home (configuration cards), the signature coordinates form (PDF viewer + boxes), and an alternate view with thumbnails, zoom and rotation. ``` cd demo make run-symfony7 # β†’ https://localhost:8001 make run-symfony8 # β†’ https://localhost:8002 ``` Twenty-plus demos: no config, default config, fixed\_url, overridden config, URL as dropdown, limited boxes, same signer (multiple locations), unique per name (array), page restriction, sorted boxes, no-overlap, allow-overlap, **min-size-boxes**, rotation, defaults-by-name, snap-to-grid, **guides-and-grid**, **viewer lazy-load**, **AcroForm editor**, **AcroForm editor min-size**, latest features (combined), predefined boxes; plus signing (draw, upload, legal disclaimer, predefined boxes β€” sign only, signing options). See [demo/README.md](demo/README.md) and [demo/Makefile](demo/Makefile). ### Xdebug [](#xdebug) Demos include **Xdebug**. Your IDE should listen on port **9003**. To start only on demand, set `XDEBUG_START_WITH_REQUEST=trigger` in the demo `docker-compose.yml` and use your IDE trigger. Frontend (Vite + TypeScript) ---------------------------- [](#frontend-vite--typescript) The PDF viewer is built with **Vite** and **TypeScript**. The bundle ships a built file at `src/Resources/public/js/pdf-signable.js`. After installing the bundle: ``` php bin/console assets:install ``` To rebuild from source (bundle root): ``` pnpm install pnpm run build ``` Tests and QA ------------ [](#tests-and-qa) From the bundle root (optionally via Docker): ``` make up make install make test # PHPUnit make test-coverage # PHPUnit + HTML (coverage/) and Clover (coverage.xml). Requires PCOV in the container. make cs-check # PHP-CS-Fixer make qa # cs-check + test make validate-translations # Validate translation YAML files (inside Docker) ``` Or locally: `composer test`, `composer test-coverage`, `composer cs-check`, `composer qa`. The bundle Docker image includes PCOV for coverage. Documentation ------------- [](#documentation) - [Installation](docs/INSTALLATION.md) - [Configuration](docs/CONFIGURATION.md) - [Usage](docs/USAGE.md) - [Contributing](docs/CONTRIBUTING.md) - [Changelog](docs/CHANGELOG.md) - [Upgrading](docs/UPGRADING.md) - [Release](docs/RELEASE.md) - [Security](docs/SECURITY.md) - [Engram](docs/ENGRAM.md) - [Roadmap](docs/ROADMAP.md) ### Additional documentation [](#additional-documentation) - [Demo with FrankenPHP (development and production)](docs/DEMO-FRANKENPHP.md) - [Workflow](docs/WORKFLOW.md) - [AcroForm backend](docs/ACROFORM_BACKEND_EXTENSION.md) - [Events](docs/EVENTS.md) - [Advanced signing](docs/SIGNING_ADVANCED.md) - [Styles](docs/STYLES.md) - [Testing](docs/TESTING.md) - [Accessibility](docs/ACCESSIBILITY.md) Tests and coverage ------------------ [](#tests-and-coverage) - Tests: PHPUnit (PHP), pytest (Python scripts) - PHP: 99.18% - TS/JS: 81.28% - Python: 21% License ------- [](#license) The MIT License (MIT). Please see [LICENSE](LICENSE) for more information. Contributing ------------ [](#contributing) We welcome contributions! Please see [CONTRIBUTING.md](docs/CONTRIBUTING.md) for details on how to contribute to this project. For security issues see [SECURITY.md](docs/SECURITY.md). Author ------ [](#author) Created by [HΓ©ctor Franco Aceituno](https://github.com/HecFranco) at [Nowo.tech](https://nowo.tech) ### Health Score 44 β€” FairBetter than 92% of packages Maintenance88 Actively maintained with recent releases Popularity18 Limited adoption so far Community8 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 88.6% of commits β€” single point of failure How is this calculated?**Maintenance (25%)** β€” Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** β€” Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** β€” Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** β€” Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 15 Last Release 77d ago Major Versions v1.5.3 β†’ v2.0.02026-02-16 ### Community Maintainers ![](https://www.gravatar.com/avatar/e7947bfc3f2ce9574a18a2c60f3d95b5d1b0740e65dc929332c92f1df21f75ab?d=identicon)[HecFranco](/maintainers/HecFranco) --- Top Contributors [![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (62 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (8 commits)") --- Tags symfonypdfsignaturesigningformpdfjsSymfony BundlecoordinatesForm Typeeidaspdf viewerdocument-signingsignature-coordinates ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/nowo-tech-pdf-signable-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/nowo-tech-pdf-signable-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-pdf-signable-bundle) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[kimai/kimai Kimai - Time Tracking 4.6k7.4k1](/packages/kimai-kimai)[contao/core-bundle Contao Open Source CMS 1231.6M2.4k](/packages/contao-core-bundle) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)