Εμφάνιση της ροής στον ιστότοπό σας

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

Οι ανακοινώσεις δημοσιεύονται με την άδεια CC BY-SA 4.0. Μια αναδημοσίευση αναφέρει λοιπόν το όνομα του εκδότη, παραπέμπει στην ανακοίνωση και ονομάζει την άδεια: η επέκταση και οι ροές παρακάτω φέρουν αυτά τα τρία στοιχεία, και η αφαίρεσή τους καθιστά το αντίγραφο μη εξουσιοδοτημένο.

Μια επέκταση ενός μόνο αρχείου, χωρίς εξαρτήσεις: χωρίς Composer, χωρίς επέκταση τρίτου, χωρίς JavaScript. Αντιγράψτε την στο wp-content/plugins/dolinews-feed/ και ενεργοποιήστε την, ή επικολλήστε το περιεχόμενό της στο τέλος του functions.php του θυγατρικού θέματός σας - το ένα ή το άλλο, ποτέ και τα δύο.

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

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

• editor, project, focus, dolibarr, q - τα ίδια φίλτρα με τη ροή.
• maturity - μια λίστα χωρισμένη με κόμματα, για παράδειγμα beta,rc. Χωρίς αυτό το χαρακτηριστικό εμφανίζονται μόνο οι σταθερές εκδόσεις.
• locale - η γλώσσα ανάγνωσης, ως τοπική ρύθμιση περιεχομένου: fr_FR, es_ES, de_DE...
• limit, layout, summary, title, link_text - η παρουσίαση: αριθμός ανακοινώσεων, λίστα ή κάρτες, εμφάνιση περίληψης ή όχι, τίτλος και κείμενο του συνδέσμου.
• cache - η διάρκεια της τοπικής προσωρινής μνήμης σε δευτερόλεπτα, 900 από προεπιλογή. Η τελευταία γνωστή απάντηση διατηρείται για μία εβδομάδα και σερβίρεται αν αυτός ο ιστότοπος γίνει απρόσιτος.

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

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

Η ροή RSS διαβάζεται από οποιονδήποτε συλλέκτη. Η ροή JSON ακολουθεί τη μορφή JSON Feed, και κάθε καταχώριση φέρει επιπλέον ένα μέλος _dolinews: τις ακατέργαστες τιμές της ανακοίνωσης - έκδοση, ωριμότητα, εύρος Dolibarr, φύση, εκδότης, έργο - και τις ήδη μεταφρασμένες ετικέτες τους. Αυτό το μέλος διαβάζει η επέκταση WordPress, και αυτό πρέπει να διαβάζεται για την εμφάνιση μιας ανακοίνωσης αλλού.

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

Αυτή η υπηρεσία λέει τι ανακοινώθηκε, και πότε. Ποτέ την τρέχουσα κατάσταση ενός αρθρώματος. Μια ενσωμάτωση που θα έγραφε "άρθρωμα συμβατό με την έκδοση 22" θα βεβαίωνε αυτό που κανείς δεν δήλωσε: το εύρος που εμφανίζεται είναι αυτό που έφερε η ανακοίνωση, στην ημερομηνία της, και η ημερομηνία εμφανίζεται δίπλα.

Για τον ίδιο λόγο, μια ωριμότητα δεν εμφανίζεται ποτέ χωρίς την παλαιότητά της - κανείς δεν επιστρέφει για να πει ότι μια έκδοση βγήκε από τη δοκιμαστική φάση - και οι δοκιμαστικές εκδόσεις απουσιάζουν όσο δεν ζητούνται.