Έλεγχος πριν από την πτήση

Το XOOPS 2.7.0 αναβάθμισε τη μηχανή προτύπων του από Smarty 3 σε Smarty 4. Το Smarty 4 είναι πιο αυστηρό σχετικά με τη σύνταξη προτύπων από το Smarty 3 και ορισμένα προσαρμοσμένα θέματα και πρότυπα λειτουργικών μονάδων μπορεί να χρειαστεί να προσαρμοστούν πριν λειτουργήσουν σωστά στο XOOPS.0.2.

Για να εντοπίσετε και να επιδιορθώσετε αυτά τα ζητήματα πριν εκτελέσετε τον κύριο αναβαθμιστή, το XOOPS 2.7.0 αποστέλλεται με έναν σαρωτή πριν από την πτήση στον κατάλογο upgrade/. Πρέπει να εκτελέσετε τον σαρωτή πριν από την πτήση τουλάχιστον μία φορά προτού η κύρια ροή εργασιών αναβάθμισης σας επιτρέψει να συνεχίσετε.

Τι κάνει ο σαρωτής

Ο σαρωτής πριν από την πτήση περιηγείται στα υπάρχοντα θέματα και πρότυπα λειτουργικών μονάδων αναζητώντας γνωστές ασυμβατότητες του Smarty 4. Μπορεί:

• Σαρώστε τους καταλόγους σας themes/ και modules/ για αρχεία προτύπων .tpl και .html που μπορεί να χρειάζονται αλλαγές
• Αναφορά ζητήματα ομαδοποιημένα ανά αρχείο και ανά τύπο προβλήματος
• Αυτόματη επιδιόρθωση πολλών συνηθισμένων προβλημάτων όταν το ζητάτε

Δεν μπορεί να επιδιορθωθεί αυτόματα κάθε πρόβλημα. Ορισμένα πρότυπα θα χρειαστούν χειροκίνητη επεξεργασία, ειδικά εάν χρησιμοποιούν παλαιότερους ιδιωματισμούς Smarty 3 που δεν έχουν άμεσο ισοδύναμο στο Smarty 4.

Εκτέλεση του σαρωτή

1. Αντιγράψτε τον κατάλογο διανομής upgrade/ στη ρίζα ιστού του ιστότοπού σας (αν δεν το έχετε ήδη κάνει ως μέρος του βήματος Προετοιμασίες για αναβάθμιση).
2. Τοποθετήστε το πρόγραμμα περιήγησής σας στο preflight URL:

   http://example.com/upgrade/preflight.php

3. Συνδεθείτε με λογαριασμό διαχειριστή όταν σας ζητηθεί.
4. Ο σαρωτής παρουσιάζει μια φόρμα με τρία στοιχεία ελέγχου:
   • Κατάλογος προτύπων — αφήστε το κενό για να σαρώσετε και τα δύο themes/ και modules/. Εισαγάγετε μια διαδρομή όπως το /themes/mytheme/ για να περιορίσετε τη σάρωση σε έναν μόνο κατάλογο.
   • Επέκταση προτύπου — αφήστε το κενό για να σαρώσετε τα αρχεία .tpl και .html. Εισαγάγετε μια μεμονωμένη επέκταση για να περιορίσετε τη σάρωση.
   • Προσπαθήστε αυτόματη επιδιόρθωση — επιλέξτε αυτό το πλαίσιο εάν θέλετε ο σαρωτής να επιδιορθώσει προβλήματα που ξέρει πώς να διορθώσει. Αφήστε το μη επιλεγμένο για σάρωση μόνο για ανάγνωση.
5. Πατήστε το κουμπί Εκτέλεση. Ο σαρωτής περπατά στους επιλεγμένους καταλόγους και αναφέρει κάθε πρόβλημα που βρίσκει.

Ερμηνευτικά Αποτελέσματα

Η αναφορά σάρωσης παραθέτει κάθε αρχείο που εξέτασε και κάθε ζήτημα που εντόπισε. Κάθε καταχώρηση τεύχους σάς λέει:

• Ποιο αρχείο περιέχει το πρόβλημα
• Ποιος κανόνας Smarty 4 παραβιάζει
• Εάν ο σαρωτής θα μπορούσε να το επιδιορθώσει αυτόματα

Εάν εκτελέσατε τη σάρωση με ενεργοποιημένη την Attempt automatic fix, η αναφορά θα επιβεβαιώσει επίσης ποια αρχεία γράφτηκαν ξανά.

Μη αυτόματη διόρθωση προβλημάτων

Για προβλήματα που ο σαρωτής δεν μπορεί να επιδιορθώσει αυτόματα, ανοίξτε το αρχείο προτύπου με σημαία σε ένα πρόγραμμα επεξεργασίας και κάντε τις απαιτούμενες αλλαγές. Οι κοινές ασυμβατότητες του Smarty 4 περιλαμβάνουν:

• {php} ... {/php} μπλοκ (δεν υποστηρίζονται πλέον στο Smarty 4)
• Καταργημένοι τροποποιητές και κλήσεις λειτουργιών
• Χρήση οριοθέτη ευαίσθητου κενού χώρου
• Υποθέσεις προσθήκης χρόνου εγγραφής που άλλαξαν στο Smarty 4

Εάν δεν αισθάνεστε άνετα με την επεξεργασία προτύπων, η πιο ασφαλής προσέγγιση είναι να μεταβείτε σε ένα θέμα που έχει αποσταλεί (xbootstrap5 , default, xswatch5, κ.λπ.) και να αντιμετωπίσετε το προσαρμοσμένο θέμα ξεχωριστά μετά την ολοκλήρωση της αναβάθμισης.

Επανεκτέλεση μέχρι να καθαριστεί

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

Μόλις η σάρωση είναι καθαρή, μπορείτε να τερματίσετε τη συνεδρία πριν από την πτήση πατώντας το κουμπί Έξοδος από το σαρωτή στη διεπαφή χρήστη του σαρωτή. Αυτό επισημαίνει την προκαταρκτική πτήση ως ολοκληρωμένη και επιτρέπει στον κύριο αναβαθμιστή στο /upgrade/ να προχωρήσει.

Συνέχεια στην αναβάθμιση

Με την ολοκλήρωση της προκαταρκτικής πτήσης, μπορείτε να εκκινήσετε τον κύριο αναβαθμιστή στη διεύθυνση:

http://example.com/upgrade/

Ανατρέξτε στο Running Upgrade για τα επόμενα βήματα.

Εάν παραλείψετε την προκαταρκτική πτήση

Η παράλειψη της προκαταρκτικής πτήσης αποθαρρύνεται ιδιαίτερα, αλλά εάν κάνατε αναβάθμιση χωρίς να την εκτελέσετε και βλέπετε τώρα σφάλματα προτύπου, ανατρέξτε στην ενότητα Σφάλματα προτύπου Smarty 4 της Αντιμετώπιση προβλημάτων. Μπορείτε να εκτελέσετε την προκαταρκτική πτήση μετά το γεγονός και να διαγράψετε το xoops_data/caches/smarty_compile/ για να ανακάμψετε.