Δημιουργία γλώσσα-εξαρτώμενων JavaScript αρχείων για τα CMS Modules
Το bluetronix CMS δημιουργεί αυτόματα βελτιστοποιημένα JavaScript αρχεία για κάθε ενεργοποιημένη γλώσσα στην ιστοσελίδα σου. Μαθαίνεις πώς τα αρχεία προτύπου, οι ατομικές προσαρμογές και οι γλώσσα-εξαρτώμενοι τίτλοι module συγχωνεύονται και πώς το CMS ενσωματώνει αυτόματα τα κατάλληλα αρχεία στην ιστοσελίδα σου.
Γλώσσα-εξαρτώμενα JavaScript αρχεία
Το bluetronix CMS μπορεί να δημιουργεί αρχεία JavaScript για κάθε ενεργοποιημένη γλώσσα της ιστοσελίδας σου. Έτσι, οι γλώσσα-εξαρτώμενοι κείμενα και λειτουργίες είναι άμεσα διαθέσιμα μέσα στο αντίστοιχο αρχείο JavaScript.
Τα απαραίτητα αρχεία δημιουργούνται αυτόματα μόλις αποθηκεύσεις μια διαμόρφωση μονάδας. Το CMS λαμβάνει υπόψη και τα πρότυπα αρχεία και τις ατομικές σου προσαρμογές.
Αυτό το tutorial βασίζεται στην τεκμηρίωση "Ενσωμάτωση και προσαρμογή CMS-μονάδων". Θα πρέπει ήδη να είσαι εξοικειωμένος με τον φάκελο προγραμματιστή bx_Mod και τη χρήση δικών σου _own-αρχείων.
1. Αυτόματη δημιουργία των JavaScript αρχείων
Όταν αποθηκεύεις μια διαμόρφωση μονάδας, το CMS αυτόματα αναδημιουργεί όλα τα απαραίτητα γλώσσα-εξαρτώμενα αρχεία JavaScript.
Δημιουργούνται μόνο οι γλωσσικές εκδόσεις που έχεις ενεργοποιήσει μέσω της μονάδας Lang.
Οι ενεργοποιημένες γλώσσες καθορίζονται μέσω της παγκόσμιας διαμόρφωσης της μονάδας:
bx_Mod/config_own.phpΑν, για παράδειγμα, έχεις ενεργοποιήσει τα Γερμανικά, Αγγλικά και Ισπανικά, το CMS δημιουργεί αντίστοιχα αρχεία JavaScript για αυτές τις τρεις γλώσσες.
Η αλλαγή του χρωματικού συνόλου ή του σχεδίου δεν επηρεάζει πια τα αρχεία JavaScript. Η αυτόματη αναδημιουργία συμβαίνει κατά την αποθήκευση μιας διαμόρφωσης μονάδας.
2. Χειροκίνητη δημιουργία JavaScript αρχείων
Επιπλέον της αυτόματης δημιουργίας, μπορείς να ζητήσεις την χειροκίνητη δημιουργία των γλώσσα-εξαρτώμενων αρχείων JavaScript.
Για να το κάνεις αυτό, ως διαχειριστής, επισκέψου τη διεύθυνση που ακολουθεί. Αντικατέστησε το παράδειγμα τομέα με τη διεύθυνση του CMS σου:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpΜε αυτή την κλήση μπορείς να αναδημιουργήσεις τα αρχεία JavaScript ανεξάρτητα από την αποθήκευση μιας διαμόρφωσης μονάδας.
3. Παγκόσμια ρύθμιση module
Η παγκόσμια διαμόρφωση της μονάδας βρίσκεται υπό:
bx_Mod/config_own.phpΑυτό το αρχείο περιέχει τις ατομικές ρυθμίσεις του έργου σου. Ρυθμίζεται μετά την εγκατάσταση σύμφωνα με τις απαιτήσεις του χρήστη.
Εδώ καθορίζεται μεταξύ άλλων ποιες μονάδες και περιοχές θα χρησιμοποιηθούν, π.χ. Κατάστημα ή Ιστολόγιο. Επιπλέον, λαμβάνονται υπόψη οι ενεργοποιημένες γλώσσες.
Η διαμόρφωση αποτελεί μια σημαντική βάση για τη δημιουργία των γλώσσα-εξαρτώμενων αρχείων JavaScript.
4. Διαμορφώσεις μονάδας και αρχεία γλώσσας
Κατά την δημιουργία, το CMS λαμβάνει υπόψη τα αρχεία διαμόρφωσης των αντίστοιχων μονάδων. Αυτά περιλαμβάνουν τη διαμόρφωση προτύπου, ατομικές προσαρμογές και γλώσσα-εξαρτώμενα κείμενα.
Στο παράδειγμα της μονάδας Καταστήματος, αυτά είναι:
bx_Mod/Shop/config.php
bx_Mod/Shop/config_own.php
bx_Mod/Shop/config_text_de.php
bx_Mod/Shop/config_text_de_own.phpΤα αρχεία εκτελούν διάφορες λειτουργίες:
config.php: Περιέχει την τυπική ρύθμιση του module του καταστήματος.
config_own.php: Περιέχει τις προσωπικές σου ρυθμίσεις.
config_text_de.php: Περιέχει τα τυπικά γερμανόφωνο κείμενα του module του καταστήματος.
config_text_de_own.php: Περιέχει τις προσωπικές σου προσαρμογές των γερμανόφωνων κειμένων.
Για άλλες ενεργοποιημένες γλώσσες θα ληφθούν υπόψη τα αντίστοιχα αρχεία γλώσσας.
Απόφυγε να αλλάξεις τα τυπικά αρχεία απευθείας. Χρησιμοποίησε τα προβλεπόμενα αρχεία _own για τις προσωπικές σου προσαρμογές, ώστε οι αλλαγές σου να διατηρηθούν κατά τις κανονικές ενημερώσεις του CMS.
5. Πρότυπο JavaScript και δικές προσαρμογές
Τα γενικά αρχεία JavaScript βρίσκονται στον φάκελο προγραμματιστών bx_script.
Για τις κεντρικές λειτουργίες JavaScript θα ληφθούν υπόψη τα εξής αρχεία:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js είναι το τυπικό αρχείο του CMS bluetronix. Μπορεί να αντικατασταθεί κατά τις ενημερώσεις συστήματος.
Τα αρχεία BxScript_own.js και BxScript_own_min.js προορίζονται για προσωπικές προσαρμογές.
Αυτά τα αρχεία μπορούν να ληφθούν υπόψη κατά την παραγωγή των γλωσσικά-εξαρτώμενων αρχείων JavaScript.
6. Header-JavaScript και δικές προσαρμογές
Εκτός από τα γενικά αρχεία JavaScript, υπάρχουν ξεχωριστά αρχεία για την κεφαλίδα της ιστοσελίδας σου.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js περιέχει τις κεφαλίδες JavaScript που παρέχονται από το CMS. Αυτό το τυπικό αρχείο μπορεί να αντικατασταθεί κατά μια ενημέρωση συστήματος.
Για τις προσωπικές προσαρμογές είναι διαθέσιμα τα BxHeadScript_own.js και BxHeadScript_own_min.js.
Από αυτά τα αρχεία δημιουργούνται οι αντίστοιχες γλωσσικά-εξαρτώμενες εκδόσεις.
7. Δημιουργημένα αρχεία JavaScript
Από τα υπάρχοντα αρχεία ρυθμίσεων, γλώσσας και JavaScript, το CMS δημιουργεί ξεχωριστά αρχεία για κάθε ενεργοποιημένη γλώσσα.
Για παράδειγμα, δημιουργούνται τα εξής γενικά αρχεία JavaScript:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsΕπιπλέον, δημιουργούνται τα αντίστοιχα αρχεία JavaScript κεφαλίδας:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsΟι γλωσσικές συντομογραφίες δηλώνουν τη συγκεκριμένη γλώσσα. Για παράδειγμα, de για γερμανικά, en για αγγλικά, ru για ρωσικά και es για ισπανικά.
Το CMS δημιουργεί μόνο τα αρχεία για τις πραγματικά ενεργοποιημένες γλώσσες.
8. Βελτιστοποίηση των δημιουργημένων αρχείων JavaScript
Κατά την παραγωγή, τα αρχεία JavaScript βελτιστοποιούνται επιπλέον. Έτσι, μπορούν να αφαιρεθούν περιττά σχόλια και άχρηστο κενό.
Η απλή βελτιστοποίηση περιλαμβάνει τα εξής βήματα:
1. Γραμμές που ξεκινούν με // αφαιρούνται.
2. Γραμμές που περιέχουν αποκλειστικά κενά αφαιρούνται.
3. Πολλές κενές καταχωρήσεις μπορούν να αντικατασταθούν με μία μόνο κενή καταχώρηση.
Μια πλήρης μινιφοποίηση δεν είναι απαραίτητη αυτή τη στιγμή.
Η βελτιστοποίηση μειώνει τα περιττά περιεχόμενα μέσα στα παραγόμενα αρχεία JavaScript.
9. Αυτόματη ενσωμάτωση γλώσσα-εξαρτώμενων αρχείων JavaScript
Το bluetronix CMS ελέγχει κατά τη δημιουργία της ιστοσελίδας σου αν υπάρχει το αντίστοιχο αρχείο JavaScript για τη γλώσσα που έχεις επιλέξει.
Στο HTML layout, η γενική JavaScript μπορεί να έχει ενσωματωθεί μέσω της εξής CMS-σημείωσης:
__FV_/bx_script/BxScript_own_min.js__Όταν ο επισκέπτης καλεί την γερμανική εκδοχή της ιστοσελίδας σου και το αντίστοιχο αρχείο γλώσσας είναι διαθέσιμο, το CMS αντικαθιστά αυτόματα τη σημείωση με:
__FV_/bx_script/BxScript_de.js__Το ίδιο αρχ принцип ισχύει και για το αρχείο header-JavaScript.
Από:
__FV_/bx_script/BxHeadScript_own_min.js__θα γίνει για παράδειγμα:
__FV_/bx_script/BxHeadScript_de.js__Η υπάρχουσα HTML ενσωμάτωσή δεν χρειάζεται να προσαρμοστεί ξεχωριστά για κάθε γλώσσα.
Αν δεν υπάρχει κατάλληλο αρχείο γλώσσας, παραμένει ενεργό το γενικό αρχείο JavaScript.
10. Ενημέρωση της μνήμης cache του προγράμματος περιήγησης με βάση την ημερομηνία αλλαγής αρχείου
Για να αποτρέψεις τους φυλλομετρητές να φορτώνουν μια παλιά έκδοση του αρχείου JavaScript από τη μνήμη cache μετά από μια αλλαγή, το CMS μπορεί επιπλέον να χρησιμοποιήσει την ημερομηνία αλλαγής του αντίστοιχου αρχείου.
Το ενσωματωμένο αρχείο JavaScript θα λάβει για αυτό έναν παράμετρο έκδοσης.
Παράδειγμα:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMΑν αλλάξει το αρχείο, μπορεί να αλλάξει επίσης και ο παράμετρος έκδοσης. Έτσι, ο φυλλομετρητής αναγνωρίζει την αλλαγμένη έκδοση του αρχείου και μπορεί να την φορτώσει ξανά.
Αυτή η διαδικασία μπορεί να χρησιμοποιηθεί τόσο για τα γενικά αρχεία JavaScript όσο και για τα αρχεία header-JavaScript.
11. Περίληψη
Το bluetronix CMS δημιουργεί αυτόματα ξεχωριστά αρχεία JavaScript για κάθε ενεργοποιημένη γλώσσα της ιστοσελίδας σου.
Η δημιουργία συμβαίνει κάθε φορά που αποθηκεύεις μια ρύθμιση μονάδας. Επιπλέον, μπορείς να την ξεκινήσεις χειροκίνητα μέσω του bx_Mod/BxScript.php.
Κατά τη δημιουργία λαμβάνονται υπόψη η παγκόσμια ρύθμιση της μονάδας, τα αρχεία ρύθμισης και γλώσσας των μονάδων καθώς και τα αρχεία JavaScript που είναι προεπιλεγμένα και τα δικά σου.
Στο layout, το CMS αναγνωρίζει αυτόματα αν υπάρχει κατάλληλο αρχείο γλώσσας και το ενσωματώνει αντί του γενικού αρχείου JavaScript.
Χρησιμοποίησε για ατομικές προσαρμογές πρωτίστως τα προβλεπόμενα αρχεία _own, ώστε οι αλλαγές σου να διατηρούνται κατά τις κανονικές ενημερώσεις συστήματος.
Συχνές Ερωτήσεις
τι ρωτούν συχνά οι πελάτες μας
Πότε δημιουργούνται τα γλωσσικά εξαρτώμενα αρχεία JavaScript;
Το bluetronix CMS δημιουργεί τα αρχεία αυτόματα μόλις αποθηκεύσεις μια ρύθμιση μονάδας. Κατά τη διαδικασία αυτή, τα αρχεία JavaScript για όλες τις ενεργοποιημένες γλώσσες αναδημιουργούνται.
Πώς μπορώ να ξαναδημιουργήσω τα αρχεία JavaScript χειροκίνητα;
Σαν διαχειριστής, επισκέψου τη διεύθυνση https://xxxx.bxserver.net/bx_Mod/BxScript.php. Αντικατάστησε τη διεύθυνση παραδείγματος με τη διεύθυνση του CMS σου.
Δημιουργούνται αρχεία JavaScript για όλες τις διαθέσιμες γλώσσες;
Όχι. Το CMS δημιουργεί αποκλειστικά τις γλωσσικές εκδόσεις που έχεις ενεργοποιήσει μέσω της μονάδας Lang. Οι αντίστοιχες ρυθμίσεις ορίζονται στο bx_Mod/config_own.php.
Αλλάζουν τα αρχεία JavaScript όταν αλλάζει το χρωματικό σύνολο ή το layout;
Όχι. Το χρωματικό σύνολο ή η διάταξη δεν επηρεάζει πλέον τα αρχεία JavaScript. Η αυτόματη αναδημιουργία πραγματοποιείται κατά την αποθήκευση μιας διαμόρφωσης μονάδας.
Ποια αρχεία μπορώ να προσαρμόσω ατομικά;
Για ατομικές προσαρμογές JavaScript, είναι διαθέσιμα τα BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js και BxHeadScript_own_min.js. Επίσης, οι μονάδες έχουν δικές τους διαμορφώσεις και αρχεία γλώσσας με την ένδειξη _own.
Τι συμβαίνει με τα πρότυπα αρχεία JavaScript κατά μια ενημέρωση CMS;
Τα πρότυπα αρχεία BxScript.js και BxHeadScript.js μπορούν να αντικατασταθούν κατά την ενημέρωση του συστήματος. Γι' αυτό, πρέπει να αποθηκεύετε τις δικές σας αλλαγές μόνο στα αντίστοιχα αρχεία _own.
Πώς αναγνωρίζει το CMS ποιο αρχείο JavaScript πρέπει να συμπεριληφθεί;
Το CMS ελέγχει κατά τη δημιουργία της ιστοσελίδας αν υπάρχει ένα αντίστοιχο αρχείο JavaScript για την τρέχουσα επιλεγμένη γλώσσα. Εάν υπάρχει, για παράδειγμα, το BxScript_de.js, αυτό θα συμπεριληφθεί για την γερμανική γλώσσα αντί του γενικού αρχείου.
Πώς μπορώ να εμποδίσω τους επισκέπτες να φορτώνουν παλιά αρχεία JavaScript από την προσωρινή μνήμη του προγράμματος περιήγησης;
Το CMS μπορεί να χρησιμοποιήσει επιπλέον την ημερομηνία αλλαγής αρχείου ως παράμετρο έκδοσης κατά τη συμπερίληψη των αρχείων JavaScript. Έτσι, ο browser μπορεί να φορτώσει τη νέα έκδοση του αρχείου μετά από μια αλλαγή.