Deployed 6cc7bf5 with MkDocs version: 1.5.3

Author: Jako

404.html

@@ -369,7 +369,7 @@ <h1>404 - Not found</h1>
       <div class="md-copyright">
 
     <div class="md-copyright__highlight">
-      &copy; 2015-2022 <a href="https://treehillstudio.com">Treehill Studio</a>
+      &copy; 2015-2025 <a href="https://treehillstudio.com">Treehill Studio</a>
     </div>
 
 

contributors/index.html

@@ -415,7 +415,7 @@ <h1>Contributors</h1>
       <div class="md-copyright">
 
     <div class="md-copyright__highlight">
-      &copy; 2015-2022 <a href="https://treehillstudio.com">Treehill Studio</a>
+      &copy; 2015-2025 <a href="https://treehillstudio.com">Treehill Studio</a>
     </div>
 
 

index.html

@@ -546,7 +546,7 @@ <h3 id="translations">Translations <a href="https://hosted.weblate.org/projects/
       <div class="md-copyright">
 
     <div class="md-copyright__highlight">
-      &copy; 2015-2022 <a href="https://treehillstudio.com">Treehill Studio</a>
+      &copy; 2015-2025 <a href="https://treehillstudio.com">Treehill Studio</a>
     </div>
 
 

installation/index.html

@@ -530,7 +530,7 @@ <h2 id="build-it-from-source">Build it from source</h2>
       <div class="md-copyright">
 
     <div class="md-copyright__highlight">
-      &copy; 2015-2022 <a href="https://treehillstudio.com">Treehill Studio</a>
+      &copy; 2015-2025 <a href="https://treehillstudio.com">Treehill Studio</a>
     </div>
 
 

search/search_index.json

@@ -514,6 +514,15 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#tips-and-tricks" class="md-nav__link">
+    <span class="md-ellipsis">
+      Tips and tricks
+    </span>
+  </a>
+  
 </li>
 
     </ul>
@@ -731,6 +740,15 @@
     </span>
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#tips-and-tricks" class="md-nav__link">
+    <span class="md-ellipsis">
+      Tips and tricks
+    </span>
+  </a>
+  
 </li>
 
     </ul>
@@ -1030,8 +1048,8 @@ <h4 id="example_3">Example</h4>
 <h2 id="linking-to-a-generated-pdf">Linking to a generated PDF</h2>
 <p>All generated static PDF files are saved with the aliaspath of the generating
 resource. If you want to create a link to that PDF file, you could use the
-following code:</p>
-<div class="highlight"><pre><span></span><code><span class="p">&lt;</span><span class="nt">a</span> <span class="na">href</span><span class="o">=</span><span class="s">&quot;[[*id:pdfresourcelink]]&quot;</span><span class="p">&gt;</span>PDF<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>
+following code. The output filter returns <code>-</code> if the file does not exist:</p>
+<div class="highlight"><pre><span></span><code>[[*id:pdfresourcelink:ne=`-`:then=`<span class="p">&lt;</span><span class="nt">a</span> <span class="na">href</span><span class="o">=</span><span class="s">&quot;[[*id:pdfresourcelink]]&quot;</span><span class="p">&gt;</span>PDF<span class="p">&lt;/</span><span class="nt">a</span><span class="p">&gt;</span>`:else=``]]
 </code></pre></div>
 <h2 id="debug-htmlcss-output">Debug HTML/CSS output</h2>
 <p>The pre-rendered HTML or CSS output handled by mPDF can be debugged with the
@@ -1040,6 +1058,12 @@ <h2 id="debug-htmlcss-output">Debug HTML/CSS output</h2>
 URL parameter. The result will be the HTML or CSS code that is handled by mPDF.</p>
 <p>That way you can identify wrong image paths etc. in this code. Don't forget to
 disable the <code>pdfresource.debug</code> system setting afterwards.</p>
+<h2 id="tips-and-tricks">Tips and tricks</h2>
+<p>If you want to change the filename of the generated PDF on the fly, you have to
+create a new plugin that runs before PDFResource in OnWebPagePrerender. This
+plugin has to execute <code>$modx-&gt;resource-&gt;set('alias', 'invoice_'
+. date('Ymd', $invoice-&gt;get('date')) . '_' . $invoice-&gt;get('client_id'))</code> to set the
+alias on the fly (it works even without saving $modx-&gt;resource).</p>
 
 
 
@@ -1071,7 +1095,7 @@ <h2 id="debug-htmlcss-output">Debug HTML/CSS output</h2>
       <div class="md-copyright">
 
     <div class="md-copyright__highlight">
-      &copy; 2015-2022 <a href="https://treehillstudio.com">Treehill Studio</a>
+      &copy; 2015-2025 <a href="https://treehillstudio.com">Treehill Studio</a>
     </div>