Editoria11y για Drupal

Βασικά χαρακτηριστικά

Το άρθρωμα Drupal συνδέει τη βιβλιοθήκη ελέγχου με το συντακτικό backend και προσθέτει πολλά εργαλεία από την πλευρά του διακομιστή για αναφορές, διακυβέρνηση και διαμόρφωση

Εγκατάσταση και βασικά βήματα ρύθμισης

Το πακέτο εγκατάστασης στο Drupal.org περιλαμβάνει αρκετά αρθρώματα:

• Editoria11y: ο βασικός ελεγκτής περιεχομένου και πίνακας ελέγχου.
• Editoria11y CSA: έλεγχοι προγραμματιστή και εργαλεία συντήρησης πίνακα ελέγχου.
• Editoria11y Export: εργαλεία αναφορών CSV.

Εγκαταστήστε όπως κάθε άλλο άρθρωμα και στη συνέχεια ακολουθήστε αυτά τα βασικά βήματα:

1. Ελέγξτε τα δικαιώματα. Οι έμπιστοι συγγραφείς θα πρέπει να έχουν «Επισήμανση ως OK», «Επισήμανση ως αγνοημένο» και «Προβολή του πίνακα ελέγχου».
2. Ελέγξτε βασικές σελίδες για επαναλαμβανόμενες ή μη χρήσιμες ειδοποιήσεις. Είτε επισημάνετέ τες ως OK στην επεξήγηση, είτε προσαρμόστε τη διαμόρφωση για αγνόηση στοιχείων με βάση τον επιλογέα.
3. Αναζητήστε συμβουλές που είναι δύσκολο να δείτε – εκτός οθόνης, περικομμένες, πίσω από άλλα στοιχεία ή σε κρυφά στοιχεία. Χρησιμοποιήστε τις συμβουλές στην ενότητα «Διόρθωση τοποθέτησης συμβουλών» παρακάτω.
4. Εάν ο ιστότοπος έχει ήδη περιεχόμενο και έχετε συνδρομή CSA, επισκεφτείτε την καρτέλα «επανέλεγχος» του πίνακα ελέγχου και σαρώστε τον ιστότοπο για προφόρτωση των αναφορών. Αυτό είναι προαιρετικό, αλλά οι παλαιότερες σελίδες δεν θα εμφανιστούν στις αναφορές μέχρι να σαρωθούν ή να επισκεφτούν από συνδεδεμένο χρήστη.

Δείτε μια βιντεοπαρουσίαση των επιλογών διαμόρφωσης (v2.4).

Απόκρυψη μη χρήσιμων ειδοποιήσεων

Οι καλές διαμορφώσεις καταστέλλουν τις μη χρήσιμες ειδοποιήσεις, ώστε οι συγγραφείς περιεχομένου να μπορούν να εστιάσουν σε ζητήματα που πρέπει να διορθώσουν.

Ενώ μπορείτε να απενεργοποιήσετε εντελώς τους ελέγχους, είναι συνήθως καλύτερο να αποκρύψετε ειδοποιήσεις σε συγκεκριμένα στοιχεία ή σελίδες.

Κατά τη διάρκεια κάθε εκτέλεσης ελέγχου, το Editoria11y συλλέγει ένα σύνολο στοιχείων από τη ρύθμιση «Έλεγχος περιεχομένου σε αυτά τα containers» και στη συνέχεια τα φιλτράρει αρκετές φορές. Αυτή είναι η μορφή μιας εκτέλεσης ελέγχου:

1. Ακύρωση ελέγχου εάν η διαμόρφωση αποτρέπει τον έλεγχο σε αυτή τη σελίδα ή για αυτόν τον χρήστη.
2. Συλλογή στοιχείων σε καθορισμένες περιοχές σελίδας, π.χ.:
   body > *:not('.ed11y-element')
   Για χρήστες Editoria11y CSA, αυτές είναι οι περιοχές στην καρτέλα Έλεγχοι προγραμματιστή.
3. Απόρριψη στοιχείων που ταιριάζουν με επιλογείς αγνόησης, π.χ.:
   .widgets, .utility-menu
   Για χρήστες Editoria11y CSA, αυτοί είναι οι επιλογείς στην καρτέλα Έλεγχοι προγραμματιστή.
4. Εκτέλεση ελέγχων και συγχρονισμός αποτελεσμάτων με τον πίνακα ελέγχου.
5. Εάν η διαχωρισμένη διαμόρφωση είναι ενεργή και ο χρήστης είναι συντάκτης περιεχομένου, φιλτράρισμα των αποτελεσμάτων προγραμματιστή:
   • Απόρριψη αποτελεσμάτων από ελέγχους που έχουν οριστεί ως «Μόνο για προγραμματιστές».
   • Απόρριψη αποτελεσμάτων σε στοιχεία εκτός καθορισμένων περιοχών περιεχομένου, π.χ.:
     main, footer
   • Απόρριψη αποτελεσμάτων σε στοιχεία που ταιριάζουν με επιλογείς αγνόησης περιεχομένου.
   Σημειώστε ότι δεν υπάρχει δεύτερη φάση «συλλογής». Οι περιοχές σελίδας προγραμματιστή πρέπει να περιλαμβάνουν τις περιοχές περιεχομένου.
6. Άνοιγμα του πάνελ και σχεδίαση ειδοποιήσεων εάν η διαμόρφωση ταιριάζει με μια ρύθμιση αυτόματου ανοίγματος.

Απόρριψη ειδοποιήσεων

Οι έλεγχοι μπορούν να διαμορφωθούν στη βιβλιοθήκη ως σφάλματα ή προειδοποιήσεις («χειροκίνητοι έλεγχοι»). Οι προειδοποιήσεις μπορούν να απορριφθούν. Υπάρχουν δύο τύποι απορρίψεων διαθέσιμοι από το υποσέλιδο κάθε επεξήγησης:

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

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

Αγνόηση στοιχείων

Αυτές οι δύο ρυθμίσεις διαμόρφωσης είναι οι πιο σημαντικές!

Ρυθμίστε το πρώτο ώστε να περιλαμβάνει όλα τα μέρη του περιεχομένου σελίδας που μπορούν να επεξεργαστούν οι συγγραφείς. Π.χ., εάν μπορούν να επεξεργαστούν την περιοχή περιεχομένου main, το .sidebar και το .footer-column-two, ορίστε αυτούς τους επιλογείς ως περιοχή ελέγχου περιεχομένου.

Χρησιμοποιήστε το δεύτερο για να «αποκλείσετε» υποενότητες. Π.χ., εάν το main περιέχει διάφορα widgets και embeds που μόνο προγραμματιστές μπορούν να τροποποιήσουν, καταχωρίστε αυτά: .widget-1, .social-embed;

Εάν χρησιμοποιείτε τη διαχωρισμένη διαμόρφωση, θα δείτε ένα παρόμοιο ζεύγος ρυθμίσεων στην καρτέλα Έλεγχοι προγραμματιστή:

Το βασικό που πρέπει να γνωρίζετε σχετικά με τις περιοχές ελέγχου προγραμματιστή είναι ότι δεν είναι ανεξάρτητες από τις περιοχές ελέγχου περιεχομένου. Σε μια διαχωρισμένη διαμόρφωση, οι περιοχές προγραμματιστή ελέγχονται και στη συνέχεια τα αποτελέσματα φιλτράρονται ώστε να ταιριάζουν με τις περιοχές περιεχομένου. Οποιεσδήποτε περιοχές εξαιρούνται για τους προγραμματιστές θα εξαιρούνται επίσης για τους συντάκτες περιεχομένου. Μην εξαιρείτε επεξεργάσιμες περιοχές περιεχομένου!

Ορισμένοι έλεγχοι επιτρέπουν πιο ακριβή διαμόρφωση, για απόκρυψη μόνο συγκεκριμένων ειδοποιήσεων σε επηρεαζόμενα στοιχεία. Αναζητήστε τους στις ενότητες:

• Έλεγχοι περιεχομένου: Σύνδεσμοι προς έλεγχο
• Έλεγχοι περιεχομένου: Ενσωματώσεις προς έλεγχο
• Έλεγχοι περιεχομένου: Ανίχνευση δυναμικού και shadow περιεχομένου
• Έλεγχοι προγραμματιστή: Αντίθεση

Απόκρυψη για συγκεκριμένες σελίδες ή χρήστες

Ο ευκολότερος τρόπος για να το κάνετε αυτό είναι περνώντας CSS κλάσεις ή αναγνωριστικά σε αυτές τις επιλογές:

Το πρώτο θα αποτρέψει την εκτέλεση των ελέγχων και η γραμμή εργαλείων δεν θα εμφανιστεί.

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

Εάν θέλετε να τα χρησιμοποιήσετε για να ελέγξετε ποιοι χρήστες βλέπουν τον ελεγκτή, μπορεί να χρειαστεί να προσαρμόσετε το θέμα σας ώστε να εξάγει μια κλάση, π.χ. .user-247

Διαχείριση αποτελεσμάτων σε επίπεδο ιστοτόπου

Διόρθωση κρυφών ή εκτός οθόνης συμβουλών

Το άρθρωμα παρέχει πεδία για δύο από τις επιλογές διαμόρφωσης της βιβλιοθήκης που αλλάζουν τον τρόπο τοποθέτησης των συμβουλών:

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

Ορισμένα θέματα έχουν widgets που εναλλάσσουν την ορατότητα του περιεχομένου, όπως ακορντεόν, καρτέλες και slideshows. Οι συμβουλές μέσα σε αυτά τα στοιχεία θα είναι επίσης κρυφές. Η παροχή μιας λίστας επιλογέων για αυτά τα widgets σημαίνει ότι το Editoria11y θα κάνει σύντομη παύση όταν ένας χρήστης προσπαθήσει να μεταβεί σε αυτές τις συμβουλές χρησιμοποιώντας τα κουμπιά επόμενο ή προηγούμενο. Τα θέματα και τα αρθρώματα Drupal μπορούν στη συνέχεια να ακολουθήσουν τις οδηγίες από την ενότητα της βιβλιοθήκης σχετικά με τη διαχείριση συμβουλών σε κρυφό περιεχόμενο για αποκάλυψη του κρυφού περιεχομένου.

Γράψτε τη δική σας διαμόρφωση

Σε PHP: το άρθρωμα Drupal παρέχει ένα hook_editoria11y_alter_config για αλλαγή του περιεχομένου του drupalSettings.editoria11y σε ένα άρθρωμα ή θέμα. Για παράδειγμα:

Η τροποποίηση του drupalSettings βοηθά μόνο εάν η JavaScript του αρθρώματος είναι ήδη ρυθμισμένη να περνά αυτή την τιμή στη βιβλιοθήκη. Για να προσθέσετε επιπλέον παραμέτρους, πρέπει να τροποποιήσετε απευθείας το αντικείμενο JavaScript options. Το άρθρωμα ελέγχει για μια καθολική μεταβλητή JavaScript editoria11yOptionsOverride. Εάν αυτή έχει οριστεί, θα περάσει το αντικείμενο options σε μια συνάρτηση editoria11yOptions που έχετε παρέχει στο άρθρωμα ή θέμα σας. Μπορείτε πλέον να ορίσετε οποιαδήποτε από τις παραμέτρους βιβλιοθήκης.