=== VEFdocsKit ===
Contributors: vimagesericfabre, bonaldi
Author URI: https://v-images.com
Tags: merge-pdf, split-pdf, pdf-tools, image-to-pdf, pdf-merge
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.3
Stable tag: 0.2.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn images into PDF, then merge, split, reorder and number pages, from a page of your site that only your users can open.

== Description ==

**VEFdocsKit** gives the people you choose a page on your site where they drop their documents and get them back ready to use: images turned into PDF files, and nine tools to work on the pages. It is made for any activity that files documents: law firms, accountants, associations, public bodies, anyone who has to put documents in order.

Everything happens on your own server. The PDF files are read and written by the plugin itself, in plain PHP: there is no program to install on the server and no document is ever sent to another service.

**Why VEFdocsKit**

* One page for your users, with their own accounts that never open your administration, and documents that each account alone can see.
* Nothing to install on the server: no external program, no online service.
* A journal of every document handled: date, person, document, action and pages, with the file to download while it is kept. The SHA-256 fingerprint of the file received and of the file returned is recorded with each line.
* Works in the block editor, in Divi 5 and in Elementor, with the same choices in all three.
* The page takes the look of your site (font, colors, corners) unless you set its own style.
* No tracking: nothing is collected, and nothing is sent unless you yourself send a support request or choose the optional free license.

= Protected PDF files =

* This free plugin works on PDF files that are not protected. A protected file (restrictions on editing, copying or printing, or a password to open it) is refused with a clear message.
* Opening protected PDF files, including the extracts that come from administrations and company registers, is a feature of the paid extension VEFdocsKit Pro. It detects the protection on its own, in every tool, and a short message tells you when it was removed.

= Turn images into PDF =

* JPG and PNG images become PDF pages, one image per page, fitted and centered on an A4 page with a 10 mm margin.

= Nine tools for the pages =

* Merge several documents into one, with an index of the documents in front, a separator page before each one and bookmarks.
* Split a document by groups of pages or every few pages.
* Keep, delete or reorder pages, and rotate them. Pages are typed like 1-3, 5, 8- (8- means page 8 to the end).
* Number the pages, and write a watermark across them.
* Clean the information that identifies where a file came from.

Each result is kept for the number of days you set and listed in the journal like any other document.

= A page for your users =

* The plugin creates the page when you activate it. You can rename it, move it in your menu, or put the block, the module or the widget on any other page.
* You create accounts for your users. They sign in on that page and work there only: they never see your administration or the toolbar of your site.
* The documents are stored encrypted, in a protected folder, under random names, and handed out only after a check of who is asking: each account sees its own documents only.
* Limits you can change: size of a document, number of pages, number of days the files are kept.

= In your page builder =

The block editor, Divi 5 and Elementor each have a VEFdocsKit block, module or widget, with the same choices: the whole page with its tab bar, or only one screen (for example the documents in one page and the journal in another). For each one you can also set the accent color, the text color, the corner radius and the largest width; what you leave empty follows the Style tab, then your site. While you edit, the builder shows a stand-in; the page itself appears on your site.

= Your configuration, under your control =

* Export the settings to a file and import them on another site; a reset puts back what you tick, after you typed a confirmation word.
* The privacy tools of WordPress (export and erase personal data) cover the journal, and a text for your privacy policy is suggested.
* Choose whether deleting the plugin also deletes the journal and the files; by default it keeps them.

= Help and support =

The Help tab explains how to start, and each tab has the Help button of WordPress. If you ever need help, the Diagnostic and support tab sends your request to the publisher with the technical information already attached, so you have nothing to copy.

= VEFdocsKit Pro =

A separate, paid extension, VEFdocsKit Pro, works with this plugin and adds:

* The opening of protected PDF files, including the extracts that come from administrations and company registers.
* A designer of stamps, with a live preview, and the stamping of documents.
* Folders with their series of numbers.
* A simple electronic signature.
* The sharing of a folder with collaborators, and the access of visitors to one folder.
* The full journal, with the folder, the numbers, the SHA-256 fingerprints and an export.

Nothing of the free plugin is locked: the conversion and the nine tools stay as they are. [More on v-images.com](https://v-images.com/plugin-vefdocskit/).

= Other plugins by V-IMAGES =

VEFdocsKit is made by [V-IMAGES.com](https://v-images.com) (Eric Fabre). VEF stands for V-IMAGES Eric Fabre: it is the common name of this family of plugins. You may also like:

* [VEFmusic](https://wordpress.org/plugins/vefmusic/): a free plugin for band websites, with an audio player, an album showcase, a show calendar and a press kit. [More on v-images.com](https://v-images.com/plugin-vefmusic/).
* [VEFpressKit](https://wordpress.org/plugins/vefpresskit/): a downloadable press or media kit (PDF and zip) for any activity. [More on v-images.com](https://v-images.com/plugin-vefpresskit/).
* [VEFmultiBooking](https://wordpress.org/plugins/vefmultibooking/): a booking engine for rooms, activities and time slots. [More on v-images.com](https://v-images.com/plugin-vefmultibooking/).
* [VEFflipBox](https://wordpress.org/plugins/vefflipbox/): a flip box for Divi 5, the block editor and Elementor. [More on v-images.com](https://v-images.com/plugin-vefflipbox/).

== Installation ==

1. Upload the plugin and activate it. A page of documents is created for you.
2. Open VEFdocsKit > Accounts and create the accounts of the people who will use the page.
3. Send them the address of the page. They sign in there and drop their documents.
4. Optional: open the Style tab to change the look of the page, or the Settings tab for the limits and the number of days the files are kept.
5. Optional: put the VEFdocsKit block, module or widget on another page with the block editor, Divi 5 or Elementor.

== Frequently Asked Questions ==

= Does it need an external program or an online service? =

No. The PDF files are read and written by the plugin itself, in PHP. Documents never leave your server.

= Can it open a protected PDF? =

Not in this free plugin: a protected file is refused with a message. VEFdocsKit Pro detects the protection by itself, whatever you do with the file, removes the restrictions (editing, copying, printing) of the files that open without a password and tells you with a short message. It asks for the password of the others. Nothing ever guesses or breaks a password.

= Where are the documents kept? =

In a protected folder of your uploads directory, encrypted, under random names that nobody can guess, for the number of days you choose (Settings tab). They are handed out only to the people allowed to see them. The journal keeps its lines, and the fingerprints recorded with them, after the files are deleted.

= Can my users see my administration? =

No. The accounts created from the Accounts tab open the page of the documents and nothing else of your site.

= Can an account see the documents of another? =

No. Each account sees its own documents and its own journal only. By default the administrators see everything, which suits a firm that manages its own users; on a site open to several independent people, untick "Administrators can see the documents and the journal of every account" in the Settings tab.

= Does it work with Divi 5, the block editor and Elementor? =

Yes. The block editor needs nothing more. The Divi 5 module and the Elementor widget appear only when Divi 5 or Elementor is active. Divi is a product of Elegant Themes and is not included.

= Is there a limit to the size of a document? =

The plugin has its own limits (25 MB and 400 pages by default, changeable in the Settings tab). Your host sets another one for the upload of files: a higher value in the plugin changes nothing until the host raises its own limit.

= Do I need a license? =

No. The plugin is free and complete. An optional free license is offered in Help > About: it unlocks nothing and changes nothing in the plugin, it only lets the publisher keep in touch with you (news, offers on the other plugins) and answer support requests faster.

= What happens to the data when I delete the plugin? =

By default nothing is deleted, so that a new installation finds everything again. If you tick "Also delete the journal and the files" in the Settings tab before deleting the plugin, the journal, the files, the settings and the role of the users are removed.

= Where is the source code of the compiled script? =

The `src` folder and the build files (`package.json`, `tsconfig.json`, `webpack.divi.config.js`) are included in the plugin. Run `npm install` then `npm run build` to rebuild the script of the Divi 5 module (`divi5/app/build/app.js`). The block editor script (`blocks/app/editor.js`) is not compiled.

== External services ==

The plugin connects to no external service by itself, and the PDF files never leave your server. The following happens only if you decide it.

* **Optional free license (V-IMAGES, v-images.com, the plugin's publisher)** — only if you ask for it (VEFdocsKit > Help > About): nothing is sent until you fill in the form and tick the consent box. The free license unlocks nothing — the plugin works exactly the same without it; it only lets the publisher send you news and offers, and identify your site when you ask for support. When you register, the following is sent to the V-IMAGES licensing service (REST route /wp-json/vefls/v1/free-license on v-images.com): the email address you typed, the exact consent text you agreed to, your site's URL, the VEFdocsKit version and your site's language. While you are registered, each time an administrator opens the Help tab the plugin checks the registration status (on each visit until you confirm by email, then once a week), sending your license key, your site's URL and the VEFdocsKit version. When you unregister, the plugin asks the service to delete your data.
* **Support request (optional)** — only when a site administrator sends the form of VEFdocsKit > Diagnostic and support. The form sends the e-mail address you typed, the subject and the message, the address of your site, the versions of the plugin, of WordPress and of PHP, and the name and version of the theme, to the publisher's server at v-images.com. Nothing is sent otherwise.

These services are provided by V-IMAGES (Eric Fabre): [Terms of use](https://v-images.com/cgv-cgu/), [Privacy policy](https://v-images.com/politique-de-cookies-eu/).

The links of the About tab and of the help panels only open other websites: nothing is loaded from them until you click.

== Screenshots ==

1. Merge: the nine tools, the options (index, separator pages, bookmarks) and the documents in the order they will be merged.
2. The merged document: an index in front, a separator page before each document.
3. Number the pages: text, position, margin, size and first number.
4. Split: one file for each group of pages, and all of them in a ZIP.
5. The journal of the person who signed in, with a search and a date range.
6. In the administration, the accounts of the people who use the page.
7. In the administration, the limits and the number of days the files are kept.

== Changelog ==

= 0.2.6 =
* Changed: the plugin is now simply named VEFdocsKit.
* Changed: the icons of the About screen are Dashicons, and the status marks of the Accounts and Diagnostic screens are plain text signs.
* Changed: the readme describes the journal exactly. The SHA-256 fingerprints are recorded with each line; showing them in the journal and exporting it is part of VEFdocsKit Pro. Screenshots were added.

= 0.2.5 =
* New: an extension can add a tool to the grid of the Tools screen. VEFdocsKit Pro uses it to show the stamp among the other tools.
* Changed: the page of the documents stays hidden from search engines. Only a page that the webmaster opens to everyone with VEFdocsKit Pro can now be listed, and only for visitors who are not signed in.

= 0.2.4 =
* New: when a protected PDF file is opened and its protection is removed on its own (VEFdocsKit Pro), a short message now says so. It appears in the Documents screen, before stamping, and in each tool, including when files are merged. A protected file is still refused with a clear message when the extension is not installed.

= 0.2.3 =
* Fixed: with a retention of 0 days, the returned documents are now deleted as soon as they have been downloaded, as the Settings tab says. A document that is never downloaded is deleted after one day. Before, a retention of 0 kept the files for ever; the files that were kept this way are deleted too.

= 0.2.2 =
* Changed: the returned documents are stored encrypted, and the Diagnostic tab checks with a real request whether the server refuses direct access to the storage folder.
* Changed: the names of the uploaded files are cleaned as soon as they are received.
* Changed: the optional support access is no longer part of this plugin; the Diagnostic and support tab keeps the support request form.

= 0.2.1 =
* Fixed: the description of the image conversion is now exact. Each image is fitted and centered on an A4 page with a 10 mm margin.

= 0.2.0 =
* Changed: opening protected PDF files is now a feature of VEFdocsKit Pro. This free plugin reads the files that are not protected and refuses a protected one with a clear message. Install VEFdocsKit Pro 0.3.0 or later to keep unlocking.
* New: a setting, "Administrators can see the documents and the journal of every account", in the Settings tab. Turn it off on a site open to several independent people.
* New: a setting, "Delete the returned documents of a person as soon as they sign out" (Settings tab). The page tells the person before and after.
* New: the settings of the tools (last tool and options) are kept with the account instead of the browser, so they follow the person and survive a sign-out.
* New: extensions can add a line under the sign-in form.
* New: when a site opens the page to visitors without account, they can try the nine tools on three invented sample documents, without sending anything. The files are the only ones used. Extensions can replace them.
* Security: the temporary support account is explicitly kept away from the documents of the accounts, whatever its rights.
* Fixed: a refused action returned a server error instead of a plain "not allowed" answer.

= 0.1.3 =
* Changed: internal clean-up for the WordPress.org code checks. Nothing changes in how the plugin works.

= 0.1.2 =
* New: the stamp engine draws round stamps (two rings, a text along each arc, free lines in the middle). They are made in the stamp designer of VEFdocsKit Pro.

= 0.1.1 =
* New: an optional free license, in Help > About. It unlocks nothing and changes nothing in the plugin: it lets you stay in touch with the publisher (news, offers on the other plugins) and have your support requests recognised faster. Nothing is sent until you fill in the form and tick the consent box; you can unregister at any time, which deletes your data.
* New: the diagnostic shows the state of the free license (the key partly hidden).

= 0.1.0 =
* First release.

== Upgrade Notice ==

= 0.2.0 =
Protected PDF files are now opened by VEFdocsKit Pro 0.3.0 or later. If you use the Pro extension, update it too.
