Panelladikes Widgets

Πρόσθετο WordPress που εμφανίζει τα widget του panelladikes.edu.gr (υπολογισμός μορίων, βάσεις εισαγωγής, πρόγραμμα εξετάσεων, στοιχεία σχολής και Μηχανογραφικό) στις σελίδες του site σας, με ένα block του επεξεργαστή ή με shortcode.

• Χαρακτηριστικά
• Απαιτήσεις
• Εγκατάσταση
• Χρήση
• Παράμετροι
• Ενημερώσεις
• Ιδιωτικότητα και δεδομένα
• Προσαρμογή εμφάνισης (White-Label)
• Συχνά προβλήματα
• Υποστήριξη
• Ανάπτυξη
• Συνεισφορά και ασφάλεια
• Άδεια
• English summary

Χαρακτηριστικά

• Πέντε widget: calculator (υπολογισμός μορίων), baseis (βάσεις εισαγωγής), program (πρόγραμμα εξετάσεων), sxoli (στοιχεία σχολής) και mixanografiko (Μηχανογραφικό), για ΓΕΛ και ΕΠΑΛ.
• Block «Panelladikes Widget» (κατηγορία Widgets) με ζωντανή προεπισκόπηση στον επεξεργαστή και αναζήτηση σχολής.
• Shortcode [panelladikes …] για κλασικό επεξεργαστή, widgets πλαισίου και page builders.
• Το plugin δεν έχει σελίδα ρυθμίσεων, δεν δημιουργεί options (κρατά μόνο ένα προσωρινό transient του updater, που σβήνεται κατά την απεγκατάσταση), δεν βάζει cookies και δεν κάνει analytics.
• Ελληνικό και αγγλικό περιβάλλον.
• Ενημερώσεις από τις εκδόσεις (Releases) του GitHub, με έλεγχο ακεραιότητας και υπογραφής πριν από την εγκατάσταση.

Απαιτήσεις

Εγκατάσταση

1. Κατεβάστε το panelladikes-widgets.zip από τον σταθερό σύνδεσμο: https://github.com/PanelladikesApp/panelladikes-wordpress/releases/latest/download/panelladikes-widgets.zip
2. Στον πίνακα διαχείρισης: Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου, επιλέξτε το αρχείο και πατήστε Εγκατάσταση τώρα.
3. Πατήστε Ενεργοποίηση.

Προσοχή: μην κατεβάσετε το «Source code (zip)» που εμφανίζει αυτόματα το GitHub. Δεν είναι το πακέτο εγκατάστασης και δεν λειτουργεί ως πρόσθετο.

Χρήση

Block

1. Στον επεξεργαστή, προσθέστε το block Panelladikes Widget (κατηγορία Widgets).
2. Στο πλαϊνό πάνελ διαλέξτε τον τύπο του widget και το σύστημα (ΓΕΛ ή ΕΠΑΛ). Για το sxoli αναζητήστε τη σχολή με το όνομά της ή πληκτρολογήστε τον αριθμό της.
3. Ο επεξεργαστής δείχνει το πραγματικό widget. Οι ρυθμίσεις εμφάνισης βρίσκονται στο πάνελ Appearance.

Shortcode

[panelladikes type="calculator"]
[panelladikes type="baseis" edu="epal" theme="dark"]
[panelladikes type="sxoli" edu="gel" id="123"]
[panelladikes type="program" width="60%" align="center" shadow="md" radius="16"]

Το shortcode μπορεί να μπει σε οποιοδήποτε σημείο της σελίδας που εκτελεί shortcodes.

Παράμετροι

Οι ίδιες παράμετροι ισχύουν για το block και για το shortcode. Μια άκυρη τιμή αγνοείται και χρησιμοποιείται η προεπιλογή.

Οι λογικές τιμές δέχονται 1/0, true/false, yes/no, on/off. Στο block, το όνομα της παραμέτρου id είναι schoolId.

Πώς φορτώνεται

Σε κάθε σελίδα με widget το plugin φορτώνει ένα μόνο script, το https://panelladikes.edu.gr/js/embed.v2.js, με defer. Σε σελίδες χωρίς widget δεν φορτώνεται τίποτα. Το ίδιο το widget εμφανίζεται σε iframe που φορτώνεται από το panelladikes.edu.gr, δηλαδή ο επισκέπτης επικοινωνεί απευθείας με αυτό.

Ενημερώσεις

Το plugin ενημερώνεται από τις εκδόσεις του GitHub (github.com και το CDN των αρχείων των εκδόσεων). Κάθε πακέτο ελέγχεται με άθροισμα sha256 και με ψηφιακή υπογραφή Ed25519 πριν την εγκατάσταση· αν ο έλεγχος αποτύχει, η ενημέρωση δεν εγκαθίσταται και εμφανίζεται μήνυμα σφάλματος. Οι ενημερώσεις εμφανίζονται στην οθόνη Πρόσθετα και στο Πίνακας → Ενημερώσεις όπως όλες οι υπόλοιπες. Οι αυτόματες ενημερώσεις ενεργοποιούνται μόνο αν τις ενεργοποιήσετε εσείς.

Ιδιωτικότητα και δεδομένα

Το plugin δεν έχει ρυθμίσεις, δεν δημιουργεί options, δεν βάζει cookies και δεν κάνει analytics (οι υπηρεσίες Google της φόρμας email του Μηχανογραφικού, reCAPTCHA και App Check, μπορεί να βάζουν cookies ή να χρησιμοποιούν τοπική αποθήκευση). Κρατά μόνο ένα προσωρινό transient του updater (την περιγραφή της τελευταίας έκδοσης, για 12 ώρες ή 1 ώρα αν αποτύχει η ανάγνωση), που σβήνεται κατά την απεγκατάσταση. Δεν είναι όμως χωρίς επικοινωνία με εξωτερικές υπηρεσίες:

Επιπλέον, ο ίδιος ο πυρήνας του WordPress στέλνει στο wordpress.org τη λίστα των plugins του site σε κάθε έλεγχο ενημερώσεων. Αυτό δεν το κάνει το plugin.

Προσαρμογή εμφάνισης (White-Label)

Οι προσαρμογές της εμφάνισης που δεν ορίζονται από το block ή το shortcode (χρώματα, γραμματοσειρά, η ένδειξη «Powered by») ρυθμίζονται ανά site από την ομάδα του panelladikes.edu.gr. Για να τις ζητήσετε, γράψτε στο info@panelladikes.edu.gr.

Συχνά προβλήματα

Το widget δεν εμφανίζεται ή μένει κενό.

• Plugins cache ή βελτιστοποίησης με επιλογή «delay JS» ή «defer all scripts» μπορεί να καθυστερούν ή να μπλοκάρουν το script. Εξαιρέστε το panelladikes.edu.gr/js/embed.v2.js από αυτή την επιλογή.
• Αν το site στέλνει αυστηρή Content-Security-Policy, πρέπει να επιτρέπει το https://panelladikes.edu.gr στο script-src και στο frame-src.
• Αν το site στέλνει την κεφαλίδα Referrer-Policy: no-referrer, το widget αναγνωρίζει το site ως άγνωστο και εμφανίζεται με τις προεπιλεγμένες ρυθμίσεις.
• Για type="sxoli" ελέγξτε ότι το id είναι έγκυρο· χωρίς αυτό δεν εμφανίζεται τίποτα.

Ο επεξεργαστής δείχνει μήνυμα ότι η προεπισκόπηση δεν φορτώθηκε. Το widget θα εμφανίζεται κανονικά στη σελίδα. Ελέγξτε τη σύνδεσή σας και ότι τα εργαλεία αποκλεισμού περιεχομένου του browser δεν μπλοκάρουν το panelladikes.edu.gr.

Η αναζήτηση σχολής δεν δουλεύει. Πληκτρολογήστε τον αριθμό της σχολής στο πεδίο «School number».

Υποστήριξη

• Σφάλματα και προτάσεις για τον κώδικα του plugin: GitHub Issues. Δεν δίνεται δέσμευση χρόνου απάντησης.
• Ερωτήσεις για τα δεδομένα ή τα widget: info@panelladikes.edu.gr.

Ανάπτυξη

Απαιτούνται PHP 8.2+, Composer, Node.js 20+ και, για το τοπικό περιβάλλον WordPress, Docker. Το repo περιέχει .npmrc με legacy-peer-deps=true, που χρειάζεται για το npm ci και το npm install.

composer install
npm install
npm run build

Το contract/embed-contract.v2.json περιγράφει τις επιτρεπτές τιμές των παραμέτρων. Ελέγχεται με άθροισμα sha256 (npm run contract:check) και δεν τροποποιείται χειροκίνητα· αν χρειάζεται αλλαγή, ανοίξτε πρώτα ένα issue.

Η δομή του κώδικα:

Οι εκδόσεις δημιουργούνται και υπογράφονται από τους maintainers (βλ. «Releasing» στο CONTRIBUTING.md)· ο συνεισφέρων δεν χρειάζεται κλειδιά.

Συνεισφορά και ασφάλεια

Δείτε το CONTRIBUTING.md. Για αναφορά ευπάθειας δείτε το SECURITY.md. Οι αλλαγές ανά έκδοση βρίσκονται στο CHANGELOG.md.

Άδεια

GPL-2.0-or-later, βλ. LICENSE. Το όνομα και το λογότυπο «Πανελλαδικές / Panelladikes» δεν καλύπτονται από την GPL.

English summary

Panelladikes Widgets embeds the widgets of panelladikes.edu.gr (points calculator, admission bases, exam schedule, school details and Mixanografiko, for both GEL and EPAL) into WordPress with a block or the [panelladikes] shortcode.

• Requirements: WordPress 6.5+, PHP 8.2+.
• Install: download panelladikes-widgets.zip from the latest release, then Plugins → Add New → Upload Plugin → Activate. Do not use GitHub's automatic "Source code (zip)".
• Usage: [panelladikes type="calculator"], [panelladikes type="sxoli" edu="gel" id="123"]. See the parameter table above (same attributes for the block and the shortcode; invalid values fall back to the default; pedio applies to GEL only and is ignored for EPAL).
• Updates: from GitHub Releases; every package is verified with sha256 and an Ed25519 signature before it is installed.
• Privacy: the plugin has no settings, creates no options (it keeps only one temporary update-check transient, removed on uninstall), sets no cookies and runs no analytics. Pages with a widget load a script and an iframe from panelladikes.edu.gr, the block editor loads a live preview from it, and the editor's school search calls search-paneladikesapp.web.app from the user's browser. When its email form is enabled by the service, the Mixanografiko widget sends the visitor's email address (and, only by a separate choice, a newsletter subscription) directly from the browser to panelladikes.edu.gr, not through your site and not to the site owner. Site owners should mention this in their privacy policy; see docs/privacy.md.
• Support: GitHub Issues for the plugin code, with no response-time commitment; info@panelladikes.edu.gr for questions about the data or the widgets.
• License: GPL-2.0-or-later. The Panelladikes name and logo are not covered by the GPL.