Πίνακας περιεχομένων

  1. Εισαγωγή

  2. Επισκόπηση του συστήματος δημιουργίας PDF της Dolibarr

  3. Προεπιλεγμένα μοντέλα εγγράφων στο Dolibarr

  4. Εντοπισμός και Κατανόηση Αρχείων Προτύπων PDF

  5. Πώς λειτουργεί η δημιουργία PDF στο Dolibarr

  6. Επιλογή προεπιλεγμένου μοντέλου PDF

  7. Προσθήκη του λογότυπου και της επωνυμίας της εταιρείας σας

  8. Προσαρμογή κεφαλίδων και υποσέλιδων

  9. Επεξεργασία της διάταξης στοιχείων PDF

  10. Προσαρμογή στυλ γραμματοσειράς, μεγεθών και χρωμάτων

  11. Τροποποίηση δομών πινάκων για προϊόντα και υπηρεσίες

  12. Εμφάνιση ή απόκρυψη συγκεκριμένων πεδίων

  13. Προσθήκη προσαρμοσμένων πεδίων σε πρότυπα PDF

  14. Τοπική προσαρμογή και γλωσσικές παράμετροι

  15. Πρότυπα PDF και Ενσωμάτωση Ενοτήτων

  16. Δημιουργία νέου μοντέλου PDF από την αρχή

  17. Βέλτιστες πρακτικές για αναβάθμιση χωρίς απώλεια προσαρμοσμένων PDF

  18. Δοκιμή και εντοπισμός σφαλμάτων εξόδου PDF

  19. Παράγοντες Απόδοσης σε Μεγάλα Έγγραφα

  20. Συμπέρασμα

1. Εισαγωγή

Η γεννήτρια εγγράφων PDF της Dolibarr είναι ένα από τα πιο βασικά χαρακτηριστικά της. Είτε εκτυπώνετε τιμολόγια, προτάσεις, παραγγελίες ή δελτία παράδοσης, αυτά τα έγγραφα συχνά χρησιμεύουν ως επίσημη επικοινωνία με πελάτες, προμηθευτές και συνεργάτες. Αυτός ο οδηγός περιγράφει λεπτομερώς τον τρόπο προσαρμογής των εγγράφων PDF της Dolibarr ώστε να αντικατοπτρίζουν την επωνυμία, την επιχειρηματική λογική και τις προτιμήσεις διάταξης.

2. Επισκόπηση του συστήματος δημιουργίας PDF της Dolibarr

Το Dolibarr χρησιμοποιεί πρότυπα PDF που βασίζονται σε PHP για τη δημιουργία εγγράφων. Αυτά τα πρότυπα είναι αρχεία PHP που βρίσκονται σε συγκεκριμένους καταλόγους ανάλογα με τον τύπο του εγγράφου (π.χ., τιμολόγια, παραγγελίες). Το Dolibarr χρησιμοποιεί το TCPDF, μια ευρέως χρησιμοποιούμενη βιβλιοθήκη PHP ανοιχτού κώδικα, για την απόδοση αυτών των PDF.

Κάθε ενότητα (όπως τα τιμολόγια ή οι προτάσεις) έχει τη δική της λογική δημιουργίας PDF και αρχεία προτύπων.

3. Προεπιλεγμένα μοντέλα εγγράφων στο Dolibarr

Κάθε τύπος εγγράφου προσφέρει πολλά τυπικά μοντέλα:

  • Τιμολόγια: καβούρι, αζούρ, φρέζα

  • Προτάσεις: elyse, azur

  • Παραγγελίες: Αϊνστάιν, Καρακόλε

  • Αποστολές: rouget, expedition_lettre

Αυτά τα μοντέλα μπορούν να επιλεγούν από τη διαμόρφωση κάθε ενότητας και να χρησιμεύσουν ως σημεία εκκίνησης για την προσαρμογή.

4. Εντοπισμός και Κατανόηση Αρχείων Προτύπων PDF

Τα αρχεία προτύπων αποθηκεύονται σε:

/htdocs/core/modules/<module>/doc/

Για παράδειγμα, τα πρότυπα τιμολογίων βρίσκονται σε:

/htdocs/core/modules/facture/doc/

Κάθε μοντέλο αντιστοιχεί σε ένα .php αρχείο, π.χ., pdf_crabe.modules.phpΑυτά τα αρχεία ορίζουν τη διάταξη, τη λογική κεφαλίδας/υποσέλιδου και τον τρόπο απόδοσης των δεδομένων.

5. Πώς λειτουργεί η δημιουργία PDF στο Dolibarr

Κατά τη δημιουργία ενός PDF:

  1. Το Dolibarr φορτώνει την επιλεγμένη κλάση προτύπου

  2. Ανακτά επιχειρηματικά δεδομένα (τιμολόγιο, πρόταση κ.λπ.)

  3. Χρησιμοποιεί το TCPDF για να γράψει περιεχόμενο γραμμή προς γραμμή

  4. Αποθηκεύει την έξοδο στο /documents/ φάκελο

Η όλη διαδικασία ενεργοποιείται κάνοντας κλικ στο Δημιουργία PDF κουμπί μέσα σε ένα έγγραφο.

6. Επιλογή προεπιλεγμένου μοντέλου PDF

  1. Πηγαίνετε στο Ρύθμιση > Ενότητες > [Όνομα ενότητας]

  2. Μεταβείτε στην επιλογή Πρότυπα PDF τμήμα

  3. Επιλέξτε το προτιμώμενο μοντέλο ως προεπιλογή

  4. Προαιρετικά, απενεργοποιήστε άλλους για να αποτρέψετε την εναλλαγή χρηστών

Αυτό ορίζει τη διάταξη που χρησιμοποιείται για όλα τα δημιουργημένα έγγραφα αυτού του τύπου.

7. Προσθήκη του λογότυπου και της επωνυμίας της εταιρείας σας

Τα λογότυπα διαχειρίζονται από: Ρύθμιση > Εταιρεία/Οργανισμός

Για να προσθέσετε ένα προσαρμοσμένο λογότυπο:

  1. Ανεβάστε μια εικόνα λογότυπου (κατά προτίμηση JPEG ή PNG)

  2. Βεβαιωθείτε ότι έχει τοποθετηθεί σε /logos/

  3. Πρότυπα όπως pdf_crabe θα το ενσωματώσει αυτόματα

Για περισσότερο έλεγχο, επεξεργαστείτε το write_file() μέθοδο στο αρχείο προτύπου για να αλλάξετε τη θέση ή το μέγεθος του λογότυπου.

8. Προσαρμογή κεφαλίδων και υποσέλιδων

Οι κεφαλίδες συνήθως περιλαμβάνουν:

  • Όνομα εταιρείας

  • Διεύθυνση

  • Τίτλος εγγράφου

  • Αριθμός αναφοράς

Τα υποσέλιδα ενδέχεται να περιέχουν:

  • Αριθμοί σελίδας

  • Νομικές πληροφορίες

  • Όροι και προϋποθέσεις

Αυτά μπορούν να προσαρμοστούν στο πρότυπο pdf->SetHeader() και pdf->SetFooter() λογική ή απευθείας μέσα write_file().

9. Επεξεργασία της διάταξης των στοιχείων PDF

Μπορείτε να προσαρμόσετε:

  • Περιθώρια και γεμίσματα

  • Στυλ γραμματοσειράς για τίτλους, πίνακες και σημειώσεις

  • Απόσταση μεταξύ των τμημάτων

  • Τοποθετήσεις εικόνων

Χρησιμοποιήστε μεθόδους TCPDF όπως SetXY(), MultiCell(), να Line() για την τοποθέτηση και τη μορφοποίηση περιεχομένου.

10. Προσαρμογή στυλ γραμματοσειράς, μεγεθών και χρωμάτων

Το Dolibarr χρησιμοποιεί τη μηχανή στυλ του TCPDF. Παραδείγματα:

$pdf->SetFont('dejavusans', 'B', 10);
$pdf->SetTextColor(0, 0, 0);
$pdf->SetFillColor(230, 230, 230);

Μπορείτε να αλλάξετε γραμματοσειρές (DejaVu, Courier, Helvetica) και να εφαρμόσετε έντονη/πλάγια/υπογράμμιση όπως απαιτείται.

11. Τροποποίηση δομών πινάκων για προϊόντα και υπηρεσίες

Ο κύριος πίνακας προϊόντων περιλαμβάνει:

  • Περιγραφή

  • Ποσοτητα

  • Τιμή μονάδος

  • Σύνολο

You Can:

  • Αλλαγή σειράς στηλών

  • Προσθήκη/αφαίρεση στηλών (π.χ., SKU, πληροφορίες προμηθευτή)

  • Μορφοποίηση εμφάνισης νομίσματος

Εντοπίστε τον βρόχο που επεξεργάζεται $object->lines[] στο αρχείο προτύπου και προσαρμόστε ανάλογα.

12. Εμφάνιση ή απόκρυψη συγκεκριμένων πεδίων

Για να αποκρύψετε/εμφανίσετε πεδία:

  • Χρήση σταθερών διαμόρφωσης (ορισμός μέσω Ρύθμιση > Άλλη ρύθμιση)

  • Προσθήκη λογικής υπό όρους σε PHP, π.χ.:

if (!empty($line->ref)) {
    $pdf->MultiCell(...);
}

Μπορείτε επίσης να ελέγξετε τα δικαιώματα χρήστη ή τους τύπους εγγράφων για την απόδοση περιεχομένου υπό όρους.

13. Προσθήκη προσαρμοσμένων πεδίων σε πρότυπα PDF

Αν έχετε προσθέσει επιπλέον πεδία:

  1. Βεβαιωθείτε ότι είναι ενεργοποιημένα και συμπληρωμένα στο περιβάλλον χρήστη

  2. Αποκτήστε πρόσβαση σε αυτά μέσω $object->array_options['options_fieldname']

  3. Μορφοποίηση και εισαγωγή χρησιμοποιώντας MultiCell() ή άλλες συναρτήσεις TCPDF

Τα προσαρμοσμένα πεδία λειτουργούν για τρίτα μέρη, προϊόντα και τις περισσότερες γραμμές εγγράφων.

14. Τοπική προσαρμογή και γλωσσικές παράμετροι

Τα PDF σέβονται τις ρυθμίσεις γλώσσας του Dolibarr. Εάν δημιουργείτε πολύγλωσσα έγγραφα:

  • Ορισμός γλώσσας σε $outputlangs πριν από τη σύνταξη περιεχομένου

  • Χρήση load_langs('bills') ή παρόμοιο

Βεβαιωθείτε ότι η κωδικοποίηση UTF-8 και οι γραμματοσειρές υποστηρίζουν ειδικούς χαρακτήρες.

15. Πρότυπα PDF και Ενσωμάτωση Ενοτήτων

Ορισμένες ενότητες, όπως οι Συμβάσεις ή τα Έργα, έχουν τα δικά τους πρότυπα. Εάν ενσωματώνετε δεδομένα από άλλες ενότητες:

  • Επεκτείνετε τη λογική του προτύπου για να υποβάλετε ερώτημα σε επιπλέον πεδία

  • Χρησιμοποιήστε άγκιστρα ή παρακάμψτε τα πρότυπα πυρήνα εάν είναι απαραίτητο

Να διατηρείτε πάντα καταγεγραμμένες τις εξαρτήσεις μεταξύ των μονάδων.

16. Δημιουργία νέου μοντέλου PDF από την αρχή

  1. Αντιγράψτε ένα υπάρχον μοντέλο (π.χ. pdf_crabe.modules.php)

  2. Μετονομάστε το αρχείο και την κλάση (π.χ., pdf_mycustom.modules.php και pdf_mycustom)

  3. Εγγραφείτε το ανανεώνοντας τη σελίδα ρυθμίσεων της ενότητας

  4. Δοκιμή και επανάληψη

Κρατήστε τα προσαρμοσμένα πρότυπά σας έξω /core/ αν είναι δυνατόν, για να αποφευχθούν οι αντικαταστάσεις κατά τις αναβαθμίσεις.

17. Βέλτιστες πρακτικές για αναβάθμιση χωρίς απώλεια προσαρμοσμένων PDF

  • Μην τροποποιείτε ποτέ απευθείας τα ενσωματωμένα πρότυπα

  • Αποθηκεύστε προσαρμοσμένα αρχεία σε ένα /custom/ ή κατάλογο αντιγράφων ασφαλείας

  • Χρήση ελέγχου έκδοσης (Git) για την παρακολούθηση αλλαγών

  • Δοκιμή μετά από κάθε αναβάθμιση στο Dolibarr

Επίσης, καταγράψτε τις προσαρμογές σας για την ενημέρωση της ομάδας.

18. Δοκιμή και εντοπισμός σφαλμάτων εξόδου PDF

Για εντοπισμό σφαλμάτων:

  • Χρήση print_r() or var_dump() (καταγραφή σε αρχείο, όχι σε οθόνη)

  • Έλεγχος $object δομή

  • Ελέγξτε την έξοδο TCPDF για σφάλματα διάταξης

Χρησιμοποιήστε τιμολόγια sandbox για ασφαλείς δοκιμές.

19. Παράγοντες Απόδοσης σε Μεγάλα Έγγραφα

Για τιμολόγια με πολλές γραμμές:

  • Ελαχιστοποίηση χρήσης εικόνας και γραμματοσειράς

  • Σωστή σελιδοποίηση

  • Αποφύγετε περιττές επαναλήψεις

  • Χρήση SetAutoPageBreak(true) για να αποτρέψετε την περικοπή περιεχομένου

Η ρύθμιση της απόδοσης βοηθά στην αποφυγή χρονικών ορίων ή σφαλμάτων μνήμης.

20. Σύναψη

Η προσαρμογή των εγγράφων PDF της Dolibarr επιτρέπει στις επιχειρήσεις να παράγουν επαγγελματικά, λειτουργικά και προσαρμοσμένα στην επωνυμία τους έγγραφα. Από μικρές τροποποιήσεις στη διάταξη έως τη δημιουργία εντελώς νέων προτύπων, η κατανόηση του τρόπου λειτουργίας του συστήματος PDF θα σας δώσει πλήρη έλεγχο στη δημιουργία εγγράφων.