Wikizone - Benutzerbeiträge [de]

ProcessWire - Front Page Editing

2021-02-13T10:33:47Z

84.136.109.36: /* Front Page Editing in Repeatern */

== Front End Page Editor ==
https://processwire.com/docs/front-end/front-end-editing/

* Mehrere Optionen (im Backend auswählen)
* Option A -> Automatisch
** Kann verwendet werden wenn ein Feld nur einmal auf einer Seite verwendet wird.
* Option B -> API Method Call
** Geeignet für text fields, number fields, dates...
** Nicht geeignet für Files/Images, PageTables, Repeaters or andere Felder über die man iteriert
** Statt get einfach edit nehmen
<?php echo $page->edit('body'); ?>
* Option C -> HTML Edit Tags
** Anhand ''<edit [feldname]>...</edit>'' findet PW die Felder
** Für Repeater geeignet
** Unterstüzt Inline Editor, wenn das Feld es unterstützt

* Option D -> HTML Edit Attributes
** Gleiche Funktionalität wie Tags
** edit Attribut für div, span, ... statt eigenständiges Tag
** always uses the dialog editor and does not use the inline editor.
<div edit="events">...</div>

== Konfiguration ==
* PageFrontEdit Modul installieren (Core)
* Für Option A Checkboxen anhaken
* Für Option B-C Templates berarbeiten.
== Options in Detail ==
=== Option A ===
Einfach im Backend anhaken

=== Option B ===
Statt
$page->get('field_name');
$page->edit('field_name');
Beispiel
<?php echo $page->edit('body'); ?>
=== Option C ===

Beispiel Image Feld 'photo'
<syntaxhighlight lang="php">
<edit photo>
<img src="<?=$page->image->url?>" />
</edit>
</syntaxhighlight>

Beispiel Repeater, PageTable oder Table Field
<syntaxhighlight lang="php">
<edit events>
<?php foreach($page->events as $event): ?>
<div class="event">
<h3><?=$event->title?></h3>
<p class="date"><?=$event->date?></p>
<p><?=$event->summary?></p>
</div>
<?php endforeach; ?>
</edit>
</syntaxhighlight>

Beschreibung von Ryan:

By the way, you can also use some more verbose but alternate syntax for the <edit> tags if you prefer. If your editor does syntax highlighting with your HTML, it may be more consistent (the "quotes" are optional of course):

<edit field="events"> ... </edit>
If your editable region contains multiple fields you want to be edited together, you can specify more than one:

<edit field="intro,image,events"> ... </edit>
If your field happens to be on some other page other than the one being rendered, you can also specify what page you want to be edited:

<edit field="events" page="1001"> ... </edit>
The 1001 can be any page ID or path. The above can also be shortened to this if you prefer:

<edit field="1001.events"> ... </edit>
Or this:

<edit 1001.events> ... </edit>
If you are using <edit> tags with a field that supports inline editing (like a text or CKEditor field), the inline editor will be used. Otherwise it will open a dialog to the editor.

=== Option D ===
<syntaxhighlight lang="html5">
<div edit="events">

</div>
</syntaxhighlight>
Or to specify a field from some other page (1001):

<syntaxhighlight lang="html5">
<div edit="1001.events"> ... </div>
</syntaxhighlight>
Or to specify multiple fields:

<syntaxhighlight lang="html5">
<div edit="intro,image,events"> ... </div>
</syntaxhighlight>
The "edit" attributes are stripped from the markup that gets output, so the only place you will see them is where you place them in your template file(s).

Worth noting about '''option D''' is that it '''always uses the dialog editor''' and does not use the inline editor.

== Probleme lösen ==
=== Front Page Editing in Repeatern ===
Der Editor zeigt keinen Inhalt. Bei Superadmins funktioniert es aber.
https://processwire.com/talk/topic/15357-solved-frontend-edit-on-repeater-fields/
https://github.com/processwire/processwire-issues/issues/183
Lösung: Mit Option C funktioniert es, wenn man noch das page-Attribut mit reinnimmt. Im page Attribut gibt man den Repeater an.
<syntaxhighlight lang="php">
foreach($page->repeater_field as $item) {
echo "<h3><edit field='title' page='$item'>$item->title</edit></h3>";
echo "<edit field='body' page='$item'>$item->body</edit>";
}
</syntaxhighlight>

Manchmal auch praktisch wenn man mit fields arbeitet:
<syntaxhighlight lang="php">
// Body
if($page->body){
$bodyMarkup = "<edit field=\"body\" page=\"$page\">$page->body</edit>";
}
</syntaxhighlight>

Noch ein Kopierschnipsel:
<edit field="body" page="'.$page.'">'.$page->body.'</edit>

ProcessWire - Front Page Editing

2021-02-13T10:29:14Z

84.136.109.36:

Visual Code Studio

2021-02-08T09:41:56Z

84.136.109.36: /* Nützliche Extensions */

Guter freier Editor von Microsoft. Auch für Linux und Mac verfügbar.
https://code.visualstudio.com/docs/?dv=osx (Docs für Mac)

== VCS Shortcuts ==

=== Formatieren ===
Kontextmenü oder
Cmd K F -> Auswahl formatieren
Shift Alt F -> alles formatieren

=== Kommentieren ===

=== Auswahl ===
MMB - Drag Select (beliebiger Block)
=== Multiline Cursor ===
Alt + Click -> zusätzlicher Cursor
Alt + Cmd + Pfeil -> oben oder unten zusätzlicher Cursor
Shift + Alt + Cmd + Pfeil -> Multicursor Auswahl

=== Komplette Zeilen bearbeiten (Copy, Move, Delete) ===
Alt + Pfeil -> move line
Alt + Cmd + Pfeil -> copy line
Shift + Cmd + K -> delete line

=== Refactoring ===
F2

=== Fehlermeldungen ===
F8 -> cycle durch Fehlermeldungen

== Tipparbeit mit Emmet sparen ==
https://docs.emmet.io/cheatsheet-a5.pdf
https://docs.emmet.io/cheat-sheet/
=== Beispiele ===
<pre>
Child: >
nav>ul>li

Sibling: +
div+p+bq

Climb-up: ^
div+div>p>span+em^bq (Bei Blockquote gehts wieder eine Ebene zurück)

Grouping: ()
(div>dl>(dt+dd)*3)+footer>p

Multiplication: *
ul>li*5 // 5 li Elemente

Naming and numbering: $
ul>li.sample$*5 // li mit class: sample1, sample2...

h$[title=topic$]{Headline $}*3
<h1 title="topic1">Headline 1</h1>
<h2 title="topic2">Headline 2</h2>
<h3 title="topic3">Headline 3</h3>

ul>li.item$$$*5 // item001, item002...

=== HTML Tags mit Emmet erzeugen ===
a
<a href=""></a>
a:link
<a href="http://"></a>
a:mail
<a href="mailto:"></a>
link
link:css
link:print
link:favicon
link:touch
meta
meta:utf
img:srcset, img:s
img:sizes, img:z
ul+
...
</pre>
== Nützliche Extensions ==
Live Sass Compiler
PHP Intellisense
OneDarkPro Theme

== Terminal ==
=== Slow warning ===
https://code.visualstudio.com/docs/supporting/faq#_resolving-shell-environment-is-slow-error-warning
The easiest way to investigate delays in your startup file is to:
* Open your shell's startup file (for example, in VS Code by typing ~/.bashrc or ~/.zshrc in quick open).
* Selectively comment out potentially long running operations.
* Save and fully restart VS Code until the warning or error disappears.

== Tipps ==
=== Extension Endung hinzufügen ===
File aufmachen und unten die richtige Syntax auswählen

ProcessWire - E-Mail versenden (WireMail)

2021-02-05T18:11:04Z

84.136.109.36:

Mit der WireMail Klasse kann man in ProcessWire Mails versenden. Sie wurde 2014 eingeführt und soll es ermöglichen Module zu entwickeln um den Mailversand z.B. über smtp zu realisieren.
https://processwire.com/talk/topic/5693-new-module-type-wiremail/
https://processwire.com/talk/topic/21070-how-to-sendmail-setup-with-smtpgmail-for-local-web-development/
[[Ghetto Mailer]]
[[ProcessWire - WireMailSmtp (Module)]]

https://processwire.com/api/ref/wire-mail/
Beispiel
<syntaxhighlight lang="php">
$m = $mail->new(); // option A (prefered)
$m = wireMail(); // option B (prefered)
$m = new WireMail(); // option C (not prefered)

// chained (fluent) method call usage
$m->to('user@domain.com')
->from('you@company.com')
->subject('Message Subject')
->body('Message Body')
->send();

// separate method call usage
$m->to('user@domain.com'); // specify CSV string or array for multiple addresses
$m->from('you@company.com');
$m->subject('Message Subject');
$m->body('Message Body');
$m->send();

// optionally specify “from” or “to” names as 2nd argument
$m->to('user@domain.com', 'John Smith');
$m->from('you@company.com', 'Mary Jane');

// other methods or properties you might set (or get)
$m->bodyHTML('<html><body><h1>Message Body</h1></body></html>');
$m->attachment('/path/to/file.ext');
$m->fromName('Mary Jane');
$m->toName('John Smith');
$m->header('X-Mailer', 'ProcessWire');
$m->param('-f you@company.com'); // PHP mail() param (envelope from example)

// note that the send() function always returns the quantity of messages sent
$numSent = $m->send();
</syntaxhighlight>

Manchmal kann es für E-Mails sinnvoll sein render Templates für einzelne Felder zu haben. Das geht mit der
renderField Funktion.

[[ProcessWire - Felder rendern (renderField)]]

== Attachments aus ProcessWire ==
<pre>
foreach($p->images as $image){
$imageSmall = $image->width(640);
$m->attachment($imageSmall->filename);
}
</pre>

== Versand über SMTP ==
http://modules.processwire.com/modules/wire-mail-smtp/
Kann von anderen Modulen z.B. FormbuilderPro genutzt werden. Kann aber auch genutzt werden um Massenmails zu versenden etc.

ProcessWire - WireMailSmtp (Module)

2021-02-05T18:10:32Z

84.136.109.36: Die Seite wurde neu angelegt: „ https://modules.processwire.com/modules/wire-mail-smtp/ Das geht recht gut wenn man das WireMailSmtp Modul verwendet. ProcessWire selbst kann nur php Mail. E…“

https://modules.processwire.com/modules/wire-mail-smtp/

Das geht recht gut wenn man das WireMailSmtp Modul verwendet. ProcessWire selbst kann nur php Mail. Es bietet aber eine Schnittstelle, die Module nutzen können um Mails auf andere Weise zu handeln. WireMailSmtp bietet auf diese Weise einen Versand über SMTP an.

# '''Modul''' installieren
# In den Einstellungen des Moduls die '''SMTP Daten''' hinterlegen
# Formbuilder erkennt das Mailer Module automatisch und nutzt es. Aber trotzdem mal in den Settings von Formbuilder nachschauen was ausgewählt ist. Im Zweifel den '''Versand auf SMTP stellen'''.
# In den '''Formbuilder Settings''' sollte eine E-Mail Adresse ausgewählt sein, die der Server zuläßt.

Einstellungen für KASSERVER:

smtp hostname z.B. webmynet.kasserver.com
port 465
allow connection without authentication off
smtp user z.B. m0551234 (siehe kas)
smtp passwort (siehe kas)
use start-tls OFF
use SSL ON
sender email address die adresse über die versendet wird

Einstellungen für Office365

port 587
smtp user (e-mail adresse)
smtp pass (geheim)
use start-tls ON
crypto for tls - STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT
ssl OFF (WICHTIG)

ProcessWire - FormBuilder (Module)

2021-02-05T18:10:20Z

84.136.109.36: /* Mails per smtp versenden */

https://processwire.com/store/form-builder/

== Mails per smtp versenden ==
[[ProcessWire - WireMailSmtp (Module)]]

== CSS bei einfachem embed per iFrame anpassen ==
Einfache Lösung:
* auf Basic Output stellen
* Standard CSS von /site/templates/FormBuilder/main.css kopieren
* Neuen Pfad im Formbuilder Formular eingeben.
Nachteil, das könnte für den User zu kompliziert sein.

== Import Daten für Standard Formular ==
Hiermit kann man schnell ein Formular erstellen. Einfach in Import Feld des Formbuilder kopieren.
Einfaches Standardformular:
<pre>
{
"action": "./",
"method": "post",
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": []
},
"framework": "Basic",
"submitText": "Senden",
"successMessage": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus. Zur Kontaktaufnahme benötigen wir entweder Ihre E-Mail oder Ihre Telefonnummer.",
"emailSubject": "Nachricht über Ihr Kontaktformular",
"responderSubject": "Auto-Response",
"saveFlags": 2,
"emailTo": "post@stephanschlegel.de",
"emailFrom": "e_mail",
"submitText1018": "Senden",
"successMessage1018": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage1018": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus.",
"frBasic_cssURL": "/site/templates/styles/forms.css",
"frFoundation_foundationURL": "/site/modules/FormBuilder/frameworks/foundation/",
"frFoundation_horizHeaderClass": "small-5 medium-3 right inline",
"frFoundation_horizContentClass": "small-7 medium-9",
"frUikit_ukURL": "/site/modules/FormBuilder/frameworks/uikit/",
"frUikit_css": "uikit.gradient.min.css",
"frUikit_horizHeaderWidth": 30,
"frAdmin_styleSet": "AdminThemeDefault/styles/main-classic.css",
"frBootstrap_bootURL": "/site/modules/FormBuilder/frameworks/bootstrap/",
"frBootstrap_bootHorizHeaderClass": "col-xs-5 col-sm-4 col-md-3",
"frBootstrap_bootHorizContentClass": "col-xs-7 col-sm-8 col-md-9",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"label1018": "Ihr Name",
"maxlength": 2048,
"requiredAttr": 1
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre Telefonnummer",
"maxlength": 2048,
"requiredAttr": 1,
"requiredIf": "e_mail=''",
"stripTags": 1
},
"e_mail": {
"type": "Text",
"label": "E-Mail",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre E-Mail",
"maxlength": 2048,
"requiredIf": "telefon=''",
"stripTags": 1
},
"ihre_nachricht": {
"type": "Textarea",
"label": "Ihre Nachricht",
"required": 1,
"label1018": "Ihre Nachricht",
"rows": 5
},
"datenschutz": {
"type": "Checkbox",
"label": "Datenschutz",
"description": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"required": 1,
"label1018": "Datenschutz",
"description1018": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"checkedValue": "Ich stimme zu"
}
}
}
</pre>
Mit Adresse...
<pre>
{
"roles": {
"form-submit": [
"guest"
],
"form-list": [],
"form-edit": [],
"form-delete": [],
"entries-list": [],
"entries-edit": [],
"entries-delete": [],
"entries-page": []
},
"framework": "Basic",
"submitText": "Senden",
"successMessage": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus. Zur Kontaktaufnahme benötigen wir entweder Ihre E-Mail oder Ihre Telefonnummer.",
"emailSubject": "Nachricht über Ihr Kontaktformular",
"responderSubject": "Auto-Response",
"saveFlags": 2,
"emailTo": "post@stephanschlegel.de",
"emailFrom": "e_mail",
"submitText1018": "Senden",
"successMessage1018": "Vielen Dank, ihre Nachricht wurde versendet.",
"errorMessage1018": "Entschuldigung, das Formular konnte nicht versendet werden. Bitte füllen Sie alle Pflichtfelder aus.",
"frBasic_cssURL": "/site/templates/styles/forms.css",
"frFoundation_foundationURL": "/site/modules/FormBuilder/frameworks/foundation/",
"frFoundation_horizHeaderClass": "small-5 medium-3 right inline",
"frFoundation_horizContentClass": "small-7 medium-9",
"frUikit_ukURL": "/site/modules/FormBuilder/frameworks/uikit/",
"frUikit_css": "uikit.gradient.min.css",
"frUikit_horizHeaderWidth": 30,
"frAdmin_styleSet": "AdminThemeDefault/styles/main-classic.css",
"frBootstrap_bootURL": "/site/modules/FormBuilder/frameworks/bootstrap/",
"frBootstrap_bootHorizHeaderClass": "col-xs-5 col-sm-4 col-md-3",
"frBootstrap_bootHorizContentClass": "col-xs-7 col-sm-8 col-md-9",
"children": {
"name_1": {
"type": "Text",
"label": "Name",
"label1018": "Ihr Name",
"maxlength": 2048,
"requiredAttr": 1
},
"telefon": {
"type": "Text",
"label": "Telefon",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre Telefonnummer",
"maxlength": 2048,
"requiredAttr": 1,
"requiredIf": "e_mail=''",
"stripTags": 1
},
"e_mail": {
"type": "Text",
"label": "E-Mail",
"required": 1,
"columnWidth": 50,
"label1018": "Ihre E-Mail",
"maxlength": 2048,
"requiredIf": "telefon=''",
"stripTags": 1
},
"ihre_adresse": {
"type": "Text",
"label": "Straße",
"columnWidth": 80,
"label1018": "Straße",
"requiredAttr": 1,
"maxlength": 2048,
"size": 100
},
"hausnummer": {
"type": "Text",
"label": "Hausnr.",
"required": 1,
"columnWidth": 20,
"label1018": "Hausnr.",
"maxlength": 2048
},
"plz_ort": {
"type": "Text",
"label": "PLZ Ort",
"label1018": "PLZ Ort",
"maxlength": 2048
},
"ihre_nachricht": {
"type": "Textarea",
"label": "Ihre Nachricht",
"required": 1,
"label1018": "Ihre Nachricht",
"rows": 5,
"requiredAttr": 1
},
"datenschutz": {
"type": "Checkbox",
"label": "Datenschutz",
"description": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"required": 1,
"label1018": "Datenschutz",
"description1018": "Mit meiner Kontaktaufnahme willige ich ein, dass meine Daten gespeichert und zur Bearbeitung meiner Anfrage/Kontaktaufnahme genutzt werden. Meine Daten werden niemals an Dritte weitergeleitet. Diese Einwilligung kann jederzeit widerrufen werden.",
"checkedValue": "1"
}
}
}
</pre>

ProcessWire - Dateien verarbeiten

2021-02-05T09:42:25Z

84.136.109.36: /* Links */

Dateien sind immer ein recht komplexes Thema. Hier sind einige Basics dazu welche Funktionen und Fieldtypes es gibt, wo Dateien gespeichert werden etc.

== Links ==
https://processwire.com/talk/topic/19876-how-to-hook-file-upload-destination/
https://wiki.stephanschlegel.de/index.php?title=ProcessWire_-_RockPdf_(Module)#Aus_Modul_in_Datei_schreiben

=== Funktionen für Files und Bilder ===
https://cheatsheet.processwire.com/#files
https://processwire.com/api/ref/wire-file-tools/

=== Pagefiles ===
Pagefiles verwalten Pagefile Objekte und diese werden wiederum in File oder Image Feldern gespeichert.
https://processwire.com/talk/topic/14840-create-pagefile-or-pageimage/
https://processwire.com/api/ref/pagefiles/

=== File Uploads in Modulen ===
Uploads funktionieren entweder über WireUpload, wenn man einen bestimmten Pfad angeben will. Oder über eine Pagefile Instanz wenn die Datei mit der Seite zusammen gespeichert wird. Im letzteren Fall erstellt man meistens ein InputfieldFile Feld. Dann muss man nicht mehr viel machen. Vorsicht, wenn man
https://processwire.com/talk/topic/21616-file-upload-inside-custom-module/
https://github.com/ryancramerdesign/ImportPagesCSV/blob/master/ImportPagesCSV.module

== Basiswissen zu Dateien ProcessWire ==
Jede Seite in ProcessWire hat einen eigenen Ordner unterhalb von
site/assets/files/
Wenn Dateien oder Bilder hochgeladen werden (egal ob API oder über ein Feld) muss die Seite gespeichert werden, sonst werden die Dateien gelöscht.

=== Wichtige Klassen und Methoden ===
* '''Pagefile''' class - Represents a single file item attached to a page, typically via a File Fieldtype.
* '''InputfieldFile''' class - One or more file uploads (sortable)
* '''WireUpload''' - Saves uploads of single or multiple files, saving them to the '''destination path'''. If the destination path does not exist, it will be created.
== Snippets ==
=== Funktionen um Dateien zu löschen ===
<pre>
$page->files->deleteAll();
$page->files->delete($pagefile);

$page->images->removeAll(); // wirearray

$page->save();
</pre>
=== Custom Directory für Dateien ===
https://processwire.com/talk/topic/19876-how-to-hook-file-upload-destination/
Mit dem InputfieldFile werden Dateien nach $page->save() automatisch mit einer Seite gespeichert. Wenn man mit den Seiten etwas spezielles vorhat, z.B. in einem Custom Ordner speichern kommt man mit einem Hook weiter.

You can Hook into InputfieldFile::processInputFile. There are other places in that Class you could also hook into, but I think processInputFile works best.

Throw the code below in ready.php

Please note:

#Starter code: not much validation going on other than checking if the field the file was uploaded to is 'course_file'
#You will have to implement other logic yourself. For instance, the code copies the file immediately it is uploaded by ProcessWire Ajax. It doesn't check if the page is actually saved. If a page is not saved and the page is reloaded, as you know, files in file fields are deleted from disk. This code does not delete the corresponding file in your custom directory
#You might want the Hook to only run if you are in admin. You can add that logic
#I've purposefully left in verbose and debugging code in there (Tracy stuff) to help you ( maybe and others) understand what's going on. I suggest you test using Tracy Debugger for a better grasp of the file upload process. Delete the debugging stuff when you've got this working as you want :-).

<syntaxhighlight lang="php">
wire()->addHookAfter("InputfieldFile::processInputFile", function(HookEvent $event) {
// @note: here, events are $input, $pagefile, $n @see: the method
// get event we are hooking into

// get arguments by index {a bit faster, but less-readable}
/* $input = $event->arguments[0];
$pagefile = $event->arguments[1];
$n = $event->arguments[2]; */
// get arguments by name
#$input = $event->argumentsByName('input');
$pagefile = $event->argumentsByName('pagefile');
#$n = $event->argumentsByName('n');

// $pagefile->field: The Field object that this file is part of.
// limit to a specific field {course_file}
if($pagefile->field->name != 'course_files') return;

# intercept file

// Tracy Debugger calls to see what's going on. Also logs Ajax inputs!
#bd($input, 'input');
#bd($n, 'input');
// @see: http://processwire.com/api/ref/pagefile/
// pagefile object
bd($pagefile, 'pagefile');
// name of the field uploading to {your 'course_file'}
bd($pagefile->field->name, 'field pagefile is part of');
// file-sanitized name of the file we've added, e.g. 'checklist_install.pdf'
bd($pagefile->basename, 'name of added file');
// full disk path where the file has been uploaded in this page's files folder...
//... in /site/assets/files/1234 where 1234 is this page's ID
// ... e.g. "F:/www/mysite/site/assets/files/1234/checklist_install.pdf"
bd($pagefile->filename, 'full disk path name of added file');
// $pagefile->page: The Page object that this file is part of
bd($pagefile->page->id, 'id of the page file added to');

// full disk path to your custom uploads directory
$customDirectory = $this->wire('config')->paths->assets . 'custom_directory/';
bd($customDirectory,'custom directory for files');

# copy file
// use ProcessWire's $files API
// @see: http://processwire.com/api/ref/files/
$files = $this->wire('files');
// copy the file(s)
$files->copy($pagefile->filename,$customDirectory . $pagefile->basename);
});
</syntaxhighlight>

=== Verwaiste Dateien ===
https://processwire.com/talk/topic/4437-delete-orphaned-filesimages-from-siteassetsfiles/page/2/
<syntaxhighlight lang="php">
<?php

$keepThumbnails = true;
$keepPimVariations = true; // Pageimage Manipulator Variations

ini_set('max_execution_time', 60 * 5); // 5 minutes, increase as needed
include("./index.php"); // bootstrap ProcessWire

if($keepPimVariations) {
if(!wire('modules')->isInstalled('PageImageManipulator')) {
$keepPimVariations = false;
} else {
// PiM is installed, but is it a version that has method getPimVariations() (Ver 0.1.0 +)
$a = wire('modules')->get('PageImageManipulator')->getModuleInfo();
$actual = preg_replace('/(\d)(?=\d)/', '$1.', str_pad("{$a['version']}", 3, "0", STR_PAD_LEFT));
$keepPimVariations = version_compare($actual, '0.1.0', '<') ? false : true;
}
}

$dir = new DirectoryIterator(wire('config')->paths->files);
foreach ($dir as $file) {
if ($file->isDot() || !$file->isDir()) {
continue;
}
$id = $file->getFilename();
if (!ctype_digit("$id")) {
continue;
}
$page = wire('pages')->get((int) $id);
if (!$page->id) {
echo "Orphaned directory: " . wire('config')->urls->files . "$id/" . $file->getBasename() . "\n";
continue;
}
// determine which files are valid for the page
$valid = array();
foreach ($page->template->fieldgroup as $field) {
if ($field->type instanceof FieldtypeFile) {
foreach ($page->get($field->name) as $file) {
$valid[] = $file->basename;
if ($field->type instanceof FieldtypeImage) {
foreach ($file->getVariations() as $f) {
$valid[] = $f->basename;
}
}
// keep thumbnails:
if ($keepThumbnails && $field->type instanceof FieldtypeCropImage) {
$crops = $field->getArray();
$crops = $crops['thumbSetting'];
$crops_a = explode("\n", $crops); // ie. thumbname,200,200 (name,width,height)
foreach ($crops_a as $crop) {
$crop = explode(",", $crop);
$prefix = wire('sanitizer')->name($crop[0]);
$valid[] = $prefix . "_" . $file->basename;
}
}
// what's about PimVariations ?
if ($keepPimVariations) {
if ($field->type instanceof FieldtypeImage) {
foreach ($file->pimLoad('x',true)->getPimVariations() as $f) {
$valid[] = $f->basename;
}
}
}
}
}
}
// now find all the files present on the page
// identify those that are not part of our $valid array
$d = new DirectoryIterator($page->filesManager->path);
foreach ($d as $f) {
if ($f->isDot() || !$f->isFile()) {
continue;
}
if (!in_array($f->getFilename(), $valid)) {
echo "Orphaned file: " . wire('config')->urls->files . "$id/" . $f->getBasename() . "\n";
// #unlink($f->getPathname());
}
}
wire('pages')->uncache($page); // just in case we need the memory
}

<?php
ini_set('max_execution_time', 60 * 5); // 5 minutes, increase as needed
include("./index.php");
$dir = new DirectoryIterator(wire('config')->paths->files);

foreach ($dir as $file) {
if ($file->isDot() || !$file->isDir()) {
continue;
}
$id = $file->getFilename();
if (!ctype_digit("$id")) {
continue;
}
$page = wire('pages')->get((int) $id);
if (!$page->id) {
echo "Orphaned directory: " . wire('config')->urls->files . "$id/" . $file->getBasename() . "\n";
continue;
}
// determine which files are valid for the page
$valid = array();
foreach ($page->template->fieldgroup as $field) {
if ($field->type instanceof FieldtypeFile) {
foreach ($page->get($field->name) as $file) {
$valid[] = $file->basename;
if ($field->type instanceof FieldtypeImage) {
foreach ($file->getVariations() as $f) {
//$valid[] = $f->basename;
}
}
// keep thumbnails:
/*
if ($field->type instanceof FieldtypeCropImage) {
$crops = $field->getArray();
$crops = $crops['thumbSetting'];
$crops_a = explode("\n", $crops); // ie. thumbname,200,200 (name,width,height)
foreach ($crops_a as $crop) {
$crop = explode(",", $crop);
$prefix = wire('sanitizer')->name($crop[0]);
$valid[] = $prefix . "_" . $file->basename;
}
}*/
}
}
}
// now find all the files present on the page
// identify those that are not part of our $valid array
$d = new DirectoryIterator($page->filesManager->path);
foreach ($d as $f) {
if ($f->isDot() || !$f->isFile()) {
continue;
}
if (!in_array($f->getFilename(), $valid)) {
echo "Orphaned file: " . wire('config')->urls->files . "$id/" . $f->getBasename() . "\n";
// unlink($f->getPathname());
}
}
wire('pages')->uncache($page); // just in case we need the memory
}
</syntaxhighlight>

ProcessWire - Dateien verarbeiten

2021-02-05T07:31:24Z

84.136.109.36:

Dateien sind immer ein recht komplexes Thema. Hier sind einige Basics dazu welche Funktionen und Fieldtypes es gibt, wo Dateien gespeichert werden etc.

== Links ==
https://processwire.com/talk/topic/19876-how-to-hook-file-upload-destination/
https://wiki.stephanschlegel.de/index.php?title=ProcessWire_-_RockPdf_(Module)#Aus_Modul_in_Datei_schreiben

=== Funktionen für Files und Bilder ===
https://cheatsheet.processwire.com/#files
https://processwire.com/api/ref/wire-file-tools/

=== File Uploads in Modulen ===
Uploads funktionieren entweder über WireUpload, wenn man einen bestimmten Pfad angeben will. Oder über eine Pagefile Instanz wenn die Datei mit der Seite zusammen gespeichert wird. Im letzteren Fall erstellt man meistens ein InputfieldFile Feld. Dann muss man nicht mehr viel machen. Vorsicht, wenn man
https://processwire.com/talk/topic/21616-file-upload-inside-custom-module/
https://github.com/ryancramerdesign/ImportPagesCSV/blob/master/ImportPagesCSV.module

== Basiswissen zu Dateien ProcessWire ==
Jede Seite in ProcessWire hat einen eigenen Ordner unterhalb von
site/assets/files/
Wenn Dateien oder Bilder hochgeladen werden (egal ob API oder über ein Feld) muss die Seite gespeichert werden, sonst werden die Dateien gelöscht.

=== Wichtige Klassen und Methoden ===
* '''Pagefile''' class - Represents a single file item attached to a page, typically via a File Fieldtype.
* '''InputfieldFile''' class - One or more file uploads (sortable)
* '''WireUpload''' - Saves uploads of single or multiple files, saving them to the '''destination path'''. If the destination path does not exist, it will be created.
== Snippets ==
=== Funktionen um Dateien zu löschen ===
<pre>
$page->files->deleteAll();
$page->files->delete($pagefile);

$page->images->removeAll(); // wirearray

$page->save();
</pre>
=== Custom Directory für Dateien ===
https://processwire.com/talk/topic/19876-how-to-hook-file-upload-destination/
Mit dem InputfieldFile werden Dateien nach $page->save() automatisch mit einer Seite gespeichert. Wenn man mit den Seiten etwas spezielles vorhat, z.B. in einem Custom Ordner speichern kommt man mit einem Hook weiter.

You can Hook into InputfieldFile::processInputFile. There are other places in that Class you could also hook into, but I think processInputFile works best.

Throw the code below in ready.php

Please note:

#Starter code: not much validation going on other than checking if the field the file was uploaded to is 'course_file'
#You will have to implement other logic yourself. For instance, the code copies the file immediately it is uploaded by ProcessWire Ajax. It doesn't check if the page is actually saved. If a page is not saved and the page is reloaded, as you know, files in file fields are deleted from disk. This code does not delete the corresponding file in your custom directory
#You might want the Hook to only run if you are in admin. You can add that logic
#I've purposefully left in verbose and debugging code in there (Tracy stuff) to help you ( maybe and others) understand what's going on. I suggest you test using Tracy Debugger for a better grasp of the file upload process. Delete the debugging stuff when you've got this working as you want :-).

<syntaxhighlight lang="php">
wire()->addHookAfter("InputfieldFile::processInputFile", function(HookEvent $event) {
// @note: here, events are $input, $pagefile, $n @see: the method
// get event we are hooking into

// get arguments by index {a bit faster, but less-readable}
/* $input = $event->arguments[0];
$pagefile = $event->arguments[1];
$n = $event->arguments[2]; */
// get arguments by name
#$input = $event->argumentsByName('input');
$pagefile = $event->argumentsByName('pagefile');
#$n = $event->argumentsByName('n');

// $pagefile->field: The Field object that this file is part of.
// limit to a specific field {course_file}
if($pagefile->field->name != 'course_files') return;

# intercept file

// Tracy Debugger calls to see what's going on. Also logs Ajax inputs!
#bd($input, 'input');
#bd($n, 'input');
// @see: http://processwire.com/api/ref/pagefile/
// pagefile object
bd($pagefile, 'pagefile');
// name of the field uploading to {your 'course_file'}
bd($pagefile->field->name, 'field pagefile is part of');
// file-sanitized name of the file we've added, e.g. 'checklist_install.pdf'
bd($pagefile->basename, 'name of added file');
// full disk path where the file has been uploaded in this page's files folder...
//... in /site/assets/files/1234 where 1234 is this page's ID
// ... e.g. "F:/www/mysite/site/assets/files/1234/checklist_install.pdf"
bd($pagefile->filename, 'full disk path name of added file');
// $pagefile->page: The Page object that this file is part of
bd($pagefile->page->id, 'id of the page file added to');

// full disk path to your custom uploads directory
$customDirectory = $this->wire('config')->paths->assets . 'custom_directory/';
bd($customDirectory,'custom directory for files');

# copy file
// use ProcessWire's $files API
// @see: http://processwire.com/api/ref/files/
$files = $this->wire('files');
// copy the file(s)
$files->copy($pagefile->filename,$customDirectory . $pagefile->basename);
});
</syntaxhighlight>

=== Verwaiste Dateien ===
https://processwire.com/talk/topic/4437-delete-orphaned-filesimages-from-siteassetsfiles/page/2/
<syntaxhighlight lang="php">
<?php

$keepThumbnails = true;
$keepPimVariations = true; // Pageimage Manipulator Variations

ini_set('max_execution_time', 60 * 5); // 5 minutes, increase as needed
include("./index.php"); // bootstrap ProcessWire

if($keepPimVariations) {
if(!wire('modules')->isInstalled('PageImageManipulator')) {
$keepPimVariations = false;
} else {
// PiM is installed, but is it a version that has method getPimVariations() (Ver 0.1.0 +)
$a = wire('modules')->get('PageImageManipulator')->getModuleInfo();
$actual = preg_replace('/(\d)(?=\d)/', '$1.', str_pad("{$a['version']}", 3, "0", STR_PAD_LEFT));
$keepPimVariations = version_compare($actual, '0.1.0', '<') ? false : true;
}
}

$dir = new DirectoryIterator(wire('config')->paths->files);
foreach ($dir as $file) {
if ($file->isDot() || !$file->isDir()) {
continue;
}
$id = $file->getFilename();
if (!ctype_digit("$id")) {
continue;
}
$page = wire('pages')->get((int) $id);
if (!$page->id) {
echo "Orphaned directory: " . wire('config')->urls->files . "$id/" . $file->getBasename() . "\n";
continue;
}
// determine which files are valid for the page
$valid = array();
foreach ($page->template->fieldgroup as $field) {
if ($field->type instanceof FieldtypeFile) {
foreach ($page->get($field->name) as $file) {
$valid[] = $file->basename;
if ($field->type instanceof FieldtypeImage) {
foreach ($file->getVariations() as $f) {
$valid[] = $f->basename;
}
}
// keep thumbnails:
if ($keepThumbnails && $field->type instanceof FieldtypeCropImage) {
$crops = $field->getArray();
$crops = $crops['thumbSetting'];
$crops_a = explode("\n", $crops); // ie. thumbname,200,200 (name,width,height)
foreach ($crops_a as $crop) {
$crop = explode(",", $crop);
$prefix = wire('sanitizer')->name($crop[0]);
$valid[] = $prefix . "_" . $file->basename;
}
}
// what's about PimVariations ?
if ($keepPimVariations) {
if ($field->type instanceof FieldtypeImage) {
foreach ($file->pimLoad('x',true)->getPimVariations() as $f) {
$valid[] = $f->basename;
}
}
}
}
}
}
// now find all the files present on the page
// identify those that are not part of our $valid array
$d = new DirectoryIterator($page->filesManager->path);
foreach ($d as $f) {
if ($f->isDot() || !$f->isFile()) {
continue;
}
if (!in_array($f->getFilename(), $valid)) {
echo "Orphaned file: " . wire('config')->urls->files . "$id/" . $f->getBasename() . "\n";
// #unlink($f->getPathname());
}
}
wire('pages')->uncache($page); // just in case we need the memory
}

<?php
ini_set('max_execution_time', 60 * 5); // 5 minutes, increase as needed
include("./index.php");
$dir = new DirectoryIterator(wire('config')->paths->files);

foreach ($dir as $file) {
if ($file->isDot() || !$file->isDir()) {
continue;
}
$id = $file->getFilename();
if (!ctype_digit("$id")) {
continue;
}
$page = wire('pages')->get((int) $id);
if (!$page->id) {
echo "Orphaned directory: " . wire('config')->urls->files . "$id/" . $file->getBasename() . "\n";
continue;
}
// determine which files are valid for the page
$valid = array();
foreach ($page->template->fieldgroup as $field) {
if ($field->type instanceof FieldtypeFile) {
foreach ($page->get($field->name) as $file) {
$valid[] = $file->basename;
if ($field->type instanceof FieldtypeImage) {
foreach ($file->getVariations() as $f) {
//$valid[] = $f->basename;
}
}
// keep thumbnails:
/*
if ($field->type instanceof FieldtypeCropImage) {
$crops = $field->getArray();
$crops = $crops['thumbSetting'];
$crops_a = explode("\n", $crops); // ie. thumbname,200,200 (name,width,height)
foreach ($crops_a as $crop) {
$crop = explode(",", $crop);
$prefix = wire('sanitizer')->name($crop[0]);
$valid[] = $prefix . "_" . $file->basename;
}
}*/
}
}
}
// now find all the files present on the page
// identify those that are not part of our $valid array
$d = new DirectoryIterator($page->filesManager->path);
foreach ($d as $f) {
if ($f->isDot() || !$f->isFile()) {
continue;
}
if (!in_array($f->getFilename(), $valid)) {
echo "Orphaned file: " . wire('config')->urls->files . "$id/" . $f->getBasename() . "\n";
// unlink($f->getPathname());
}
}
wire('pages')->uncache($page); // just in case we need the memory
}
</syntaxhighlight>

ProcessWire - RockPdf (Module)

2021-02-05T07:29:34Z

84.136.109.36: /* Aus Modul in Datei schreiben */

Modul zum Erzeugen von pdf Dateien. Basiert auf der mpdf Library.

== PDF aus HTML Vorlage ==
Beispiel aus eigener PadLoper Erweiterung
<syntaxhighlight lang="php">
// Create HTML
$t = $this->modules->get("PadRender")->getPadTemplate("invoice.php");
$t->set("order", $order);
$html = $t->render();

// Create PDF from HTML
$pdf = $this->modules->get('RockPdf');
$mpdf = $pdf->mpdf;
//$mpdf->Bookmark('RECHNUNG');
$mpdf->WriteHTML($html);
$mpdf->output();
exit();
</syntaxhighlight>

<syntaxhighlight lang="html">
<?php namespace ProcessWire;
/**
* INVOICE
* we have PadOrder object $order ready to go
*/
if(!$order->invoice_id){
echo("Für diese Bestellung wurde noch keine Rechnungsnummer erstellt. Du kannst unter Verwaltung > Padloper Rechnungen eine Nummer erstellen.");
exit();
}
$configpage = $pages->get("/site_configuration/");
$padRender = $modules->get("PadRender");
$padInvoices = $modules->get("PadInvoices"); //needed for order prefix
$prefix = $padInvoices->getPrefix();
//$padProcess = $modules->get("PadProcess");
// logo
$logo = $configpage->site_brandmark;
$logoUrl = $logo->first()->httpUrl;
//bd($order,'order');
// Customer Data
$customerAddress = '';
$customerAddress .= $order->pad_firstname . " " . $order->pad_lastname.'<br>';
if ($order->pad_address) $customerAddress .= $order->pad_address . "<br>";
if ($order->pad_address_cont) $customerAddress .= $order->pad_address_cont . "<br>";
if ($order->pad_city || $order->pad_postcode) {
if ($order->pad_postcode) $customerAddress .= $order->pad_postcode . " ";
$customerAddress .= $order->pad_city;
}
// Company Data
$companyAddress = nl2br($configpage->company_information);

// Products Table
$t = $padRender->getPadTemplate("order-products-table.php");
$t->set("order", $order);
$productsTable = $t->render();

?>
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta title="Rechnung">
<title><?= __("Invoice") ?></title>
<style>
/* LETTER A4 Styles (oriented at DIN 5008) */
body{
font-family: sans-serif;
font-size: 10pt;
}
div {
box-sizing: border-box;
/*border: 1px solid pink;*/
}
.small {
font-size: 9pt;
}
table{
border-collapse: collapse;
font-size: 10pt;
}
td{
border-top: 1px solid #999;
}
#header{
position: absolute;
top: 0;
left:0;
width: 100%;
text-align: center;
}
#logo{
padding-top:0.7cm;
width: 3cm;
}
#anschrift{
position: absolute;
top: 4.5cm;
left: 2cm;
height: 4.5cm;
width: 8.5cm;
padding-left: 0.5cm;
}
#vermerkzone{
position: absolute;
top: 0;
left: 0;
height: 1.77cm;
width: 8.5cm;
padding-top: 0.5rem;
}
#anschriftzone{
position: absolute;
top: 1.77cm;
left: 0;
width: 8.5cm;
height: 2.73cm;
}
#informationsblock{
font-size: 10pt;
position: absolute;
top: 5cm;
right: 1cm;
width: 7.5cm;
height: auto;
}
#datum{
position: relative;
text-align: right;
padding: 2rem 0 2rem 0;
}
#rechnungsnummer{
position: relative;
text-align: left;
margin-top: 1rem;
}
#textblock{
position: absolute;
top: 10.1cm;
left: 2.5cm;
right: 2cm;
height: auto;
}
#betreff{
position: absolute;
top: 2rem;
}
#text{
position: absolute;
margin-top: 1rem;
}
#rechtstexte{
position: relative;
padding-top: 1rem;
}
#footer{
text-align: center;
font-size: 9pt;
}

</style>
</head>
<body>

<div id="header" class="section">
<img id="logo" src="<?=$logoUrl?>">
</div>

<div id="anschrift">
<div id="vermerkzone" class="small" >
<div style="margin-top: 2rem; border-bottom: 1px solid black; position: relative;">
Oßwald & Schlegel GbR, Uhlandstr.3, 72820 Sonnenbühl
</div>
</div>
<div id="anschriftzone">
<?=$customerAddress?>
</div>
</div>

<div id="informationsblock">
<?=$companyAddress?>
<div id="rechnungsnummer">UStID: DE378376036<br>Rechnungsnummer: <?=$prefix.$order->invoice_id?></div>
</div>

<div id="textblock">
<div id="betreff">
<div id="datum"><?=date('d.m.Y')?></div>
<strong>RECHNUNG</strong>
</div>
<div id="text">
<?=$productsTable?>
<div id="rechtstexte">
Es wird gemäß §19 Abs. 1 Umsatzsteuergesetz keine Umsatzsteuer erhoben (Kleinunternehmerregelung).<br>
Leistungsdatum = Rechnungsdatum
</div>
</div>
</div>

<htmlpagefooter name="InvoiceFooter">
<div id="footer">
<strong>Oßwald & Schlegel GbR | Geschenke vom Lande</strong><br>
Volksbank Ermstal-Alb eG | IBAN: DE09 6409 1200 05 71 2200 02 | BIC: GENODES1MTZ | Kontoinhaber: Stephan Schlegel
</div>
</htmlpagefooter>

<sethtmlpagefooter name="InvoiceFooter" />

</body>
</html>
</syntaxhighlight>

== Weitere Beispiele ==
=== Aus Modul in Datei schreiben ===
Beispiel aus dem Modul EasyOffice (eigenes Modul)
<syntaxhighlight lang="php">
wire()->message("Rechnungs PDF wird erzeugt.");

// Create HTML
$t = $this->getPdfTemplate($this->invoicePdfTemplate);
invoicePdfTemplate is configured as module setting and defines which html template is used
// set fields
$t->set('p', $p); // make all invoice fields available in t
$positionsTable = $this->renderPositions($p);
$t->set('positionsTable', $positionsTable);
$html = $t->render();

// Create PDF from HTML
$pdf = $this->modules->get('RockPdf');
$mpdf = $pdf->mpdf;
$mpdf->Bookmark('RECHNUNG');
$mpdf->WriteHTML($html);

// Write in file
$filename = $p->invoice_number_external.'.pdf';// use invoice number as filename
$path = wire()->config->paths->siteModules.'EasyOffice/pdf/'.$filename;
$mpdf->output($path,'F'); // F->write file
return $path.$filename;

// ...

// this is how we can get our templates directory. User can place his own templates inside templates folder in an easyoffice folder
public function getPdfTemplate($file) {
$templatePath = __DIR__ . "/templates/" . $file;
if (file_exists($this->config->paths->templates . "easyoffice/" . $file)) {
$templatePath = $this->config->paths->templates . "easyoffice/" . $file;
}
return new TemplateFile($templatePath);
}
</syntaxhighlight>

==== PDF als Pagefile speichern ====
Wenn das Template ein File-Feld hat kann man die Datei an die Seite hängen:
<syntaxhighlight lang="php">
$path = $pdf->create($p);
// Attach file to invoice as pagefile (field pdf)
$p->of(false);
$p->pdf->add($path);
$p->save('pdf');
$p->save();
// Delete temporary file
unlink($path);
</syntaxhighlight>

ProcessWire - RockPdf (Module)

2021-02-05T07:03:09Z

84.136.109.36: /* Aus Modul in Datei schreiben */

ProcessWire - RockPdf (Module)

2021-02-05T07:02:19Z

84.136.109.36: /* Aus Modul in Datei schreiben */

Modul zum Erzeugen von pdf Dateien. Basiert auf der mpdf Library.

== PDF aus HTML Vorlage ==
Beispiel aus eigener PadLoper Erweiterung
<syntaxhighlight lang="php">
// Create HTML
$t = $this->modules->get("PadRender")->getPadTemplate("invoice.php");
$t->set("order", $order);
$html = $t->render();

// Create PDF from HTML
$pdf = $this->modules->get('RockPdf');
$mpdf = $pdf->mpdf;
//$mpdf->Bookmark('RECHNUNG');
$mpdf->WriteHTML($html);
$mpdf->output();
exit();
</syntaxhighlight>

<syntaxhighlight lang="html">
<?php namespace ProcessWire;
/**
* INVOICE
* we have PadOrder object $order ready to go
*/
if(!$order->invoice_id){
echo("Für diese Bestellung wurde noch keine Rechnungsnummer erstellt. Du kannst unter Verwaltung > Padloper Rechnungen eine Nummer erstellen.");
exit();
}
$configpage = $pages->get("/site_configuration/");
$padRender = $modules->get("PadRender");
$padInvoices = $modules->get("PadInvoices"); //needed for order prefix
$prefix = $padInvoices->getPrefix();
//$padProcess = $modules->get("PadProcess");
// logo
$logo = $configpage->site_brandmark;
$logoUrl = $logo->first()->httpUrl;
//bd($order,'order');
// Customer Data
$customerAddress = '';
$customerAddress .= $order->pad_firstname . " " . $order->pad_lastname.'<br>';
if ($order->pad_address) $customerAddress .= $order->pad_address . "<br>";
if ($order->pad_address_cont) $customerAddress .= $order->pad_address_cont . "<br>";
if ($order->pad_city || $order->pad_postcode) {
if ($order->pad_postcode) $customerAddress .= $order->pad_postcode . " ";
$customerAddress .= $order->pad_city;
}
// Company Data
$companyAddress = nl2br($configpage->company_information);

// Products Table
$t = $padRender->getPadTemplate("order-products-table.php");
$t->set("order", $order);
$productsTable = $t->render();

?>
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta title="Rechnung">
<title><?= __("Invoice") ?></title>
<style>
/* LETTER A4 Styles (oriented at DIN 5008) */
body{
font-family: sans-serif;
font-size: 10pt;
}
div {
box-sizing: border-box;
/*border: 1px solid pink;*/
}
.small {
font-size: 9pt;
}
table{
border-collapse: collapse;
font-size: 10pt;
}
td{
border-top: 1px solid #999;
}
#header{
position: absolute;
top: 0;
left:0;
width: 100%;
text-align: center;
}
#logo{
padding-top:0.7cm;
width: 3cm;
}
#anschrift{
position: absolute;
top: 4.5cm;
left: 2cm;
height: 4.5cm;
width: 8.5cm;
padding-left: 0.5cm;
}
#vermerkzone{
position: absolute;
top: 0;
left: 0;
height: 1.77cm;
width: 8.5cm;
padding-top: 0.5rem;
}
#anschriftzone{
position: absolute;
top: 1.77cm;
left: 0;
width: 8.5cm;
height: 2.73cm;
}
#informationsblock{
font-size: 10pt;
position: absolute;
top: 5cm;
right: 1cm;
width: 7.5cm;
height: auto;
}
#datum{
position: relative;
text-align: right;
padding: 2rem 0 2rem 0;
}
#rechnungsnummer{
position: relative;
text-align: left;
margin-top: 1rem;
}
#textblock{
position: absolute;
top: 10.1cm;
left: 2.5cm;
right: 2cm;
height: auto;
}
#betreff{
position: absolute;
top: 2rem;
}
#text{
position: absolute;
margin-top: 1rem;
}
#rechtstexte{
position: relative;
padding-top: 1rem;
}
#footer{
text-align: center;
font-size: 9pt;
}

</style>
</head>
<body>

<div id="header" class="section">
<img id="logo" src="<?=$logoUrl?>">
</div>

<div id="anschrift">
<div id="vermerkzone" class="small" >
<div style="margin-top: 2rem; border-bottom: 1px solid black; position: relative;">
Oßwald & Schlegel GbR, Uhlandstr.3, 72820 Sonnenbühl
</div>
</div>
<div id="anschriftzone">
<?=$customerAddress?>
</div>
</div>

<div id="informationsblock">
<?=$companyAddress?>
<div id="rechnungsnummer">UStID: DE378376036<br>Rechnungsnummer: <?=$prefix.$order->invoice_id?></div>
</div>

<div id="textblock">
<div id="betreff">
<div id="datum"><?=date('d.m.Y')?></div>
<strong>RECHNUNG</strong>
</div>
<div id="text">
<?=$productsTable?>
<div id="rechtstexte">
Es wird gemäß §19 Abs. 1 Umsatzsteuergesetz keine Umsatzsteuer erhoben (Kleinunternehmerregelung).<br>
Leistungsdatum = Rechnungsdatum
</div>
</div>
</div>

<htmlpagefooter name="InvoiceFooter">
<div id="footer">
<strong>Oßwald & Schlegel GbR | Geschenke vom Lande</strong><br>
Volksbank Ermstal-Alb eG | IBAN: DE09 6409 1200 05 71 2200 02 | BIC: GENODES1MTZ | Kontoinhaber: Stephan Schlegel
</div>
</htmlpagefooter>

<sethtmlpagefooter name="InvoiceFooter" />

</body>
</html>
</syntaxhighlight>

== Weitere Beispiele ==
=== Aus Modul in Datei schreiben ===
Beispiel aus dem Modul EasyOffice (eigenes Modul)
<syntaxhighlight lang="php">
wire()->message("Rechnungs PDF wird erzeugt.");
// Create HTML
$t = $this->getPdfTemplate($this->invoicePdfTemplate);
invoicePdfTemplate is configured as module setting and defines which html template is used
// set fields
$t->set('p', $p); // make all invoice fields available in t
$positionsTable = $this->renderPositions($p);
$t->set('positionsTable', $positionsTable);
$html = $t->render();
// Create PDF from HTML
$pdf = $this->modules->get('RockPdf');
$mpdf = $pdf->mpdf;
$mpdf->Bookmark('RECHNUNG');
$mpdf->WriteHTML($html);
$filename = $p->invoice_number_external.'.pdf';// use invoice number as filename
$path = wire()->config->paths->siteModules.'EasyOffice/pdf/'.$filename;
$mpdf->output($path,'F'); // F->write file
return $path.$filename;

// ...

// this is how we can get our templates directory. User can place his own templates inside templates folder in an easyoffice folder
public function getPdfTemplate($file) {
$templatePath = __DIR__ . "/templates/" . $file;
if (file_exists($this->config->paths->templates . "easyoffice/" . $file)) {
$templatePath = $this->config->paths->templates . "easyoffice/" . $file;
}
return new TemplateFile($templatePath);
}
</syntaxhighlight>

ProcessWire - RockPdf (Module)

2021-02-05T06:56:17Z

84.136.109.36:

Modul zum Erzeugen von pdf Dateien. Basiert auf der mpdf Library.

== PDF aus HTML Vorlage ==
Beispiel aus eigener PadLoper Erweiterung
<syntaxhighlight lang="php">
// Create HTML
$t = $this->modules->get("PadRender")->getPadTemplate("invoice.php");
$t->set("order", $order);
$html = $t->render();

// Create PDF from HTML
$pdf = $this->modules->get('RockPdf');
$mpdf = $pdf->mpdf;
//$mpdf->Bookmark('RECHNUNG');
$mpdf->WriteHTML($html);
$mpdf->output();
exit();
</syntaxhighlight>

<syntaxhighlight lang="html">
<?php namespace ProcessWire;
/**
* INVOICE
* we have PadOrder object $order ready to go
*/
if(!$order->invoice_id){
echo("Für diese Bestellung wurde noch keine Rechnungsnummer erstellt. Du kannst unter Verwaltung > Padloper Rechnungen eine Nummer erstellen.");
exit();
}
$configpage = $pages->get("/site_configuration/");
$padRender = $modules->get("PadRender");
$padInvoices = $modules->get("PadInvoices"); //needed for order prefix
$prefix = $padInvoices->getPrefix();
//$padProcess = $modules->get("PadProcess");
// logo
$logo = $configpage->site_brandmark;
$logoUrl = $logo->first()->httpUrl;
//bd($order,'order');
// Customer Data
$customerAddress = '';
$customerAddress .= $order->pad_firstname . " " . $order->pad_lastname.'<br>';
if ($order->pad_address) $customerAddress .= $order->pad_address . "<br>";
if ($order->pad_address_cont) $customerAddress .= $order->pad_address_cont . "<br>";
if ($order->pad_city || $order->pad_postcode) {
if ($order->pad_postcode) $customerAddress .= $order->pad_postcode . " ";
$customerAddress .= $order->pad_city;
}
// Company Data
$companyAddress = nl2br($configpage->company_information);

// Products Table
$t = $padRender->getPadTemplate("order-products-table.php");
$t->set("order", $order);
$productsTable = $t->render();

?>
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<meta title="Rechnung">
<title><?= __("Invoice") ?></title>
<style>
/* LETTER A4 Styles (oriented at DIN 5008) */
body{
font-family: sans-serif;
font-size: 10pt;
}
div {
box-sizing: border-box;
/*border: 1px solid pink;*/
}
.small {
font-size: 9pt;
}
table{
border-collapse: collapse;
font-size: 10pt;
}
td{
border-top: 1px solid #999;
}
#header{
position: absolute;
top: 0;
left:0;
width: 100%;
text-align: center;
}
#logo{
padding-top:0.7cm;
width: 3cm;
}
#anschrift{
position: absolute;
top: 4.5cm;
left: 2cm;
height: 4.5cm;
width: 8.5cm;
padding-left: 0.5cm;
}
#vermerkzone{
position: absolute;
top: 0;
left: 0;
height: 1.77cm;
width: 8.5cm;
padding-top: 0.5rem;
}
#anschriftzone{
position: absolute;
top: 1.77cm;
left: 0;
width: 8.5cm;
height: 2.73cm;
}
#informationsblock{
font-size: 10pt;
position: absolute;
top: 5cm;
right: 1cm;
width: 7.5cm;
height: auto;
}
#datum{
position: relative;
text-align: right;
padding: 2rem 0 2rem 0;
}
#rechnungsnummer{
position: relative;
text-align: left;
margin-top: 1rem;
}
#textblock{
position: absolute;
top: 10.1cm;
left: 2.5cm;
right: 2cm;
height: auto;
}
#betreff{
position: absolute;
top: 2rem;
}
#text{
position: absolute;
margin-top: 1rem;
}
#rechtstexte{
position: relative;
padding-top: 1rem;
}
#footer{
text-align: center;
font-size: 9pt;
}

</style>
</head>
<body>

<div id="header" class="section">
<img id="logo" src="<?=$logoUrl?>">
</div>

<div id="anschrift">
<div id="vermerkzone" class="small" >
<div style="margin-top: 2rem; border-bottom: 1px solid black; position: relative;">
Oßwald & Schlegel GbR, Uhlandstr.3, 72820 Sonnenbühl
</div>
</div>
<div id="anschriftzone">
<?=$customerAddress?>
</div>
</div>

<div id="informationsblock">
<?=$companyAddress?>
<div id="rechnungsnummer">UStID: DE378376036<br>Rechnungsnummer: <?=$prefix.$order->invoice_id?></div>
</div>

<div id="textblock">
<div id="betreff">
<div id="datum"><?=date('d.m.Y')?></div>
<strong>RECHNUNG</strong>
</div>
<div id="text">
<?=$productsTable?>
<div id="rechtstexte">
Es wird gemäß §19 Abs. 1 Umsatzsteuergesetz keine Umsatzsteuer erhoben (Kleinunternehmerregelung).<br>
Leistungsdatum = Rechnungsdatum
</div>
</div>
</div>

<htmlpagefooter name="InvoiceFooter">
<div id="footer">
<strong>Oßwald & Schlegel GbR | Geschenke vom Lande</strong><br>
Volksbank Ermstal-Alb eG | IBAN: DE09 6409 1200 05 71 2200 02 | BIC: GENODES1MTZ | Kontoinhaber: Stephan Schlegel
</div>
</htmlpagefooter>

<sethtmlpagefooter name="InvoiceFooter" />

</body>
</html>
</syntaxhighlight>

== Weitere Beispiele ==
=== Aus Modul in Datei schreiben ===
Beispiel aus dem Modul EasyOffice (eigenes Modul)
<syntaxhighlight lang="php">
$filename = $p->invoice_number_external.'.pdf';
$path = wire()->config->paths->siteModules.'EasyOffice/pdf/'.$filename;
$mpdf->output($path,'F');
</syntaxhighlight>