Ενσωμάτωση και προσαρμογή του CMS-Module
Σε αυτό το tutorial προσαρμόζεις το blog-module του bluetronix CMS: από την ενεργοποίηση και την ενσωμάτωση της λίστας blog μέχρι τα δικά σου αρχεία module, τις ρυθμίσεις και τα αρχεία γλώσσας.
Προϋποθέσεις και στόχος του tutorial
Για αυτό το tutorial χρειάζεσαι έναν Πρόσβαση προγραμματιστή στο bluetronix CMS. Θα πρέπει να γνωρίζεις ήδη πώς λειτουργούν οι φάκελοι προγραμματιστών και γιατί τα δικά σου αρχεία στα συστήματα φάκελοι επισημαίνονται με _own.
Χρησιμοποιούμε το υπάρχον News - Blog-module ως παράδειγμα. Ενεργοποιείς το module, ενσωματώνεις την προβολή της λίστας του σε μια σελίδα CMS και στη συνέχεια προσαρμόζεις μια δική σου αρχείο module και τη ρύθμιση. Τα αρχικά αρχεία παραμένουν αμετάβλητα.
1. Ενεργοποίηση του blog-module
Άνοιξε στο CMS Modules και επίλεξε News - Blog.
Ενεργοποίησε την επιλογή Ενεργοποίηση Blog Module και επιβεβαίωσε την ερώτηση ασφαλείας με OK.
Στη συνέχεια, θα έχεις στη διάθεσή σου τον διαμορφωτή module. Αριστερά βρίσκονται οι τεχνικές ρυθμίσεις, δεξιά οι γλωσσικά εξαρτώμενες κείμενες του module.
2. Ενσωμάτωση λίστας blog σε μια σελίδα CMS
Άνοιξε τη σελίδα /Blog/index.html και επίλεξε HTML Code. Η σελίδα blog ενσωματώνεται μέσω μιας σύντομης σήμανσης CMS.
<!--bx_Mod/Blog/Modul-Blog-List-->
Η σήμανση παραπέμπει στο blog-module και την προβολή της λίστας του. Το CMS εισάγει την παραγόμενη έξοδο του module σε αυτό το σημείο κατά την απόδοση.
3. Άνοιγμα κεντρικών αρχείων module στον διαχειριστή αρχείων
Η πραγματική λογική PHP και HTML των modules δεν βρίσκεται άμεσα στο HTML της σελίδας, αλλά κεντρικά στον φάκελο συστήματος bx_Mod. Άνοιξε πρώτα αυτόν τον φάκελο στον Διαχειριστή Αρχείων και μετά τον υποφάκελο Blog.
Στον φάκελο Blog θα βρεις, για παράδειγμα, Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, άλλα αρχεία module και τον υποφάκελο languages.
4. Προβολή προεπιλεγμένου αρχείου της λίστας blog
Επίλεξε το Modul-Blog-List.php και άνοιξέ το μέσω του Επεξεργασία.
Το αρχείο προεπιλογής περιέχει τη λογική προγράμματος για την προβολή λίστας. Στον κωδικό που παρουσιάζεται ενσωματώνονται, μεταξύ άλλων, η παραμετροποίηση του module και, αν υπάρχει, το έργο συγκεκριμένη config_own.php.
Έτσι, μια μόνο ενσωμάτωση module μπορεί να χρησιμοποιεί την ίδια κεντρική λογική προγράμματος σε διάφορες σελίδες. Για έργα που χρησιμοποιούν το πρότυπο module, οι μελλοντικές ενημερώσεις του CMS μπορούν να παρέχουν αλλαγές σε αυτό το αρχείο.
Μην επεξεργάζεσαι το αυθεντικό Modul-Blog-List.php απευθείας. Ανήκει στο σύστημα και μπορεί να αντικατασταθεί κατά τη διάρκεια ενημέρωσης του CMS.
5. Δημιουργία δικής προβολής λίστας με _own
Για να αλλάξεις την έξοδο, αντιγράφεις το αρχείο προεπιλογής. Η δική σου έκδοση θα έχει ακριβώς τον κατάλληλο _own προσδιορισμό:
Modul-Blog-List.php
↓ kopieren
Modul-Blog-List_own.php
Άνοιξε το νέο αρχείο Modul-Blog-List_own.php. Σε αυτή την έργο συγκεκριμένη έκδοση, μπορείς να αλλάξεις τη λογική PHP και την έξοδο HTML, χωρίς να πειράξεις το αρχείο προεπιλογής.
Στο τεστ μας, προσθέτουμε στον τίτλο την ευδιάκριτη ακολουθία χαρακτήρων NEW!!!!. Η υπόλοιπη προβολή λίστας παραμένει αμετάβλητη.
Αποθήκευσε το δικό σου αρχείο module και φόρτωσε ξανά τη σελίδα του blog. Το CMS χρησιμοποιεί την κατάλληλη _own έκδοση, ενώ η θέση σε /Blog/index.html παραμένει αμετάβλητη. Θα αναγνωρίσεις το ενεργό δικό αρχείο από τον μεταβαλλόμενο τίτλο NEW!!!! ΝΕΑ ΑΡΘΡΑ.
6. Ρυθμίσεις module και δική διαμόρφωση
Εκτός από την έξοδο HTML, μπορείς επίσης να αλλάξεις την παραμετροποίηση του module. Η εικόνα δείχνει στο ρυθμιστή, για παράδειγμα, για το Modul-Blog-ShowCase την τιμή DS Repeats = 3.
Αλλαγή της τιμής σε 2 και αποθήκευση της ρύθμισης. Αυτό ορίζει τον επιθυμητό αριθμό για αυτή την περιοχή ShowCase. Η ρύθμιση αφορά το Modul-Blog-ShowCase και δεν ταυτίζεται αυτόματα με τον αριθμό όλων των άρθρων της προβολής λίστας blog.
Η δική παραμετροποίηση βρίσκεται στο bx_Mod/Blog/config_own.php. Επίλεξε αυτό το αρχείο στον διαχειριστή αρχείων.
Το παρουσιαζόμενο config_own.php αντικαθιστά την τιμή στόχο μόνο όταν φορτωθεί η ενότητα module Modul-Blog-ShowCase:
if($ModulNameGB == "Modul-Blog-ShowCase") {
$CF_DS_Repeats = 2;
}
Οι προεπιλεγμένες τιμές προέρχονται από το config.php. Ένα αρχείο παραμετροποίησης δεν χρειάζεται να επαναλαμβάνει όλες τις προεπιλεγμένες τιμές, αλλά μπορεί να περιέχει μόνο τις επιθυμητές αποκλίσεις.
7. Καθορισμός πίνακα βάσης δεδομένων και σελίδων module
Στην πρότυπη παραμετροποίηση bx_Mod/Blog/config.php βρίσκεις, μεταξύ άλλων, τον χρησιμοποιούμενο πίνακα βάσης δεδομένων καθώς και τις διαδρομές για την λεπτομερή και την προβολή λίστας. Στο παρουσιαζόμενο παράδειγμα οι τιμές είναι:
$CF_DatabaseTable = "Blog";
$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";
Αν σχεδιάζεις μια δική έκδοση του blog module για διαφορετικό σκοπό, μπορείς στη δική σου παραμετροποίηση, για παράδειγμα, να καταθέσεις έναν άλλο πίνακα βάσης δεδομένων. Έλεγξε αν ο νέος πίνακας περιέχει τα πεδία που περιμένει το αρχείο module σου και αν οι σελίδες λίστας και λεπτομερειών ταιριάζουν με τη νέα έκδοση.
8. Αρχεία γλώσσας του module
Στη bx_Mod/Blog/languages βρίσκονται τα αρχεία γλώσσας του blog module. Για τις διαθέσιμες γλώσσες υπάρχουν ξεχωριστά αρχεία PHP, όπως de.php, en.php και fr.php.
Εδώ διαχειρίζονται οι γλωσσικά εξαρτώμενοι κείμενοι του module. Χρησιμοποίησε για έργο συγκεκριμένες αλλαγές τη δική μορφή αρχείου που υποστηρίζει η έκδοση του module σου, αντί να αντικαταστήσεις απευθείας τα γλωσσικά αρχεία των αρχείων.
9. Διαχωρισμός μεταξύ του προεπιλεγμένου module και της δικής σου έκδοσης
Ο κανόνας _own προστατεύει τις προσαρμογές σου από την αντικατάσταση από κανονικές ενημερώσεις. Ταυτόχρονα, είσαι υπεύθυνος εσύ για τη συντήρηση αυτής της ατομικής έκδοσης. Έλεγξε σε μελλοντικές ενημερώσεις του CMS εάν οι σημαντικές αλλαγές στο αρχείο προεπιλογής είναι επίσης σχετικές με το δικό σου αρχείο.
10. Περίληψη
Ενεργοποιείς το blog module κάτω από Modules → News - Blog, ενσωματώνεις την προβολή λίστας μέσω μιας σημείωσης CMS και διαχειρίζεσαι τη βασική λογική προγράμματος κεντρικά κάτω από bx_Mod/Blog. Για δικές αλλαγές, αντιγράφεις το Modul-Blog-List.php στο Modul-Blog-List_own.php. Ρυθμίσεις που αποκλίνουν από τις προεπιλεγμένες, τις καταθέτεις αν χρειάζεται στο config_own.php.
CMS-Seite /Blog/index.html
↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-SeiteΜε αυτόν τον τρόπο, μπορείτε να επεκτείνετε ένα υπάρχον module στοχευμένα, χωρίς να αλλάξετε τα αρχικά αρχεία του συστήματος.
Συχνές Ερωτήσεις
τι ρωτούν συχνά οι πελάτες μας
Τι πρόσβαση χρειάζομαι για να προσαρμόσω τα CMS modules;
Χρειάζεστε πρόσβαση προγραμματιστή στο bluetronix CMS. Επιπλέον, θα πρέπει να γνωρίζετε τους φακέλους των προγραμματιστών και τον κανόνα _own.
Πού ενεργοποιώ το module blog;
Ανοίξτε Modules, επιλέξτε News - Blog και ενεργοποιήστε Ενεργοποίηση μονάδας Blog. Επιβεβαιώστε την ερώτηση ασφαλείας.
Πώς ενσωματώνω τη λίστα blog σε μια σελίδα CMS;
Ανοίξτε τον HTML κώδικα της επιθυμητής σελίδας και προσθέστε την ετικέτα μονάδας <!--bx_Mod/Blog/Modul-Blog-List-->.
Πρέπει να αντιγράψω ολόκληρο τον PHP κώδικα της λίστας blog στη σελίδα;
Όχι. Η σελίδα περιέχει μόνο την ετικέτα μονάδας. Η σχετική λογική φορτώνεται κεντρικά από το module blog.
Πού βρίσκεται το αρχείο προτύπου της λίστας blog;
Θα το βρείτε στο bx_Mod/Blog/Modul-Blog-List.php στην περιοχή ανάπτυξης του διαχειριστή αρχείων.
Πώς προσαρμόζω ένα αρχείο module ώστε να μπορεί να ανανεωθεί;
Αντιγράψτε το αρχείο προτύπου και επισημάνετε την αντίγραφο με _own, για παράδειγμα Modul-Blog-List_own.php. Επεξεργαστείτε μόνο αυτό το δικό σας αρχείο.
Πρέπει να αλλάξει η ετικέτα μονάδας όταν δημιουργώ ένα _own αρχείο;
Όχι. Για ένα αρχείο μονάδας που υποστηρίζεται από το CMS, μπορεί αυτόματα να χρησιμοποιηθεί η κατάλληλη _own παραλλαγή, χωρίς να αλλάξει η υπάρχουσα ενσωμάτωση μονάδας.
Ποιος είναι ο σκοπός του config_own.php;
Μέσω του bx_Mod/Blog/config_own.php, μπορείτε να αντικαταστήσετε συγκεκριμένες τιμές από την προεπιλεγμένη διαμόρφωση για το συγκεκριμένο έργο.
Τι επιτυγχάνει το DS Repeats σε αυτό το παράδειγμα;
Στο παρουσιαζόμενο παράδειγμα, η ρύθμιση για το Modul-Blog-ShowCase αλλάζει από 3 σε 2. Ορίζει τον αριθμό των επαναλήψεων αυτού του τμήματος μονάδας.
Πού καθορίζεται ποιος πίνακας βάσης δεδομένων χρησιμοποιεί το module blog;
Στη διαμόρφωση bx_Mod/Blog/config.php, στο παράδειγμα αναφέρεται $CF_DatabaseTable = "Blog";. Η αντιστοίχιση μπορεί να προσαρμοστεί για μια δική σας παραλλαγή μονάδας.
Πού μπορώ να βρω τα αρχεία γλώσσας του module blog;
Τα αρχεία PHP που βασίζονται σε γλώσσα βρίσκονται στο bx_Mod/Blog/languages, για παράδειγμα de.php και en.php.
Ποιος αναλαμβάνει τη συντήρηση ενός προσωπικού αρχείου μονάδας;
Το προσωπικό _own αρχείο παραμένει κατά τις κανονικές ενημερώσεις του CMS. Ο προγραμματιστής πρέπει να ελέγξει αν θα πρέπει να ενσωματωθούν νέες διορθώσεις σφαλμάτων ή δυνατότητες από το αρχείο προτύπου.