diff --git a/CANVIS b/CANVIS new file mode 100644 index 0000000..c7a10a0 --- /dev/null +++ b/CANVIS @@ -0,0 +1,113 @@ +bot_plus + +0.1.1 alfa (1/12/2022) +Publica un toot només per la darrera noticia trobada. +Alterna la font per publicar d'un en un el toot de les rss actualitzades + +0.2.1 β (3/12/2022) +Genera un matriu amb totes les noticies del rss +Compara amb una cadena de les dates de publicacions guardades + +Elimine l'alternança de fonts rss per avitar repeticions innecesàries + +0.2.2 β (4/12/2022) +Filtra les url de la font rss per triar els continguts que vull publicar +Inclou la utilitat per fer un log o fitxer de registre + +0.2.3 β (4/12/2022) +Separe per directoris i fitxers la configuració i els fitxers per conservar les dades que necesita per actuar +La primera utilitat es poder omplir el fitxer de dates.txt per començar a publicar només novetats. + +0.2.4 β (5/12/2022) +Reanomene els fitxers per identificar-los correctament + +0.2.5 β (7/12/2022) +Ordene les opcions de configuració. + - instància + - temps d'espera si ha de publicar més d'un toot (mínim 30 segons) +Cree la carpeta configuracio (unic fitxer a editar per qui el vulga fer servir) +Cree la carpeta /proves per anar afegint utilitats + +0.2.6 (9/12/2022) +Inclou les etiquetes en funció del contingut del text i de la url +Afegisc el nivell de registre del log per evitar que es faça molt gran. +Tres nivells: + CURT - per a producció + COMPLET - per verificar + DETALLAT - quan hi ha problemes o vols desenrrotllar una utilitat + +0.3.0 β (10/12/2022) +Alterna la visib_tut en funció del parametre triat a cfg. +El nombre determina cada quantes publicacions es farà amb la visib_tut triada a cfg. +La resta es farà com 'unlisted' (de moment). +Adaptat per a varies fonts de rss (fins a 3) + + +0.4.0 β (11/12/2022) +Incorpore un control del fitxer dates.txt Si es buida arreplega les actuals i continua. +Utilitza l'API de mastondon per arreplegar dades del perfil del bot i les utilitza al missatge. +Amb dades de l'API, fa l'agraiment als nous seguidors amb un missatge privat (directe es si va a un usuari) +Felicita quan els seguidors son multiple de 100 amb un missatge amb imatge. +Afegit el cronometre d'execució en el log. +Incorpora comentaris que fa quan hi ha un temps sense publicar. + +0.4.1 β (29/12/2022) +Les dates s'arxiven com a cadena de temps (strtotime) +Fa una resposta fixa a les mencions o respostes de les noticies publicades, sense repetir. +Inclou l'ajust al canvi horari (diferència sobre l'hora GMT) + +0.4.2 β (10/1/2023) +Afegit un sistema de còpia de seguretat per evitar duplicacions en cas de +pèrdua del fitxer de registre. +Afegit la cadena de urls com a segona verificació per evitar repeticions. + +0.4.3 β (12/02/2023) +Modificat de shell_exec a exec per introduir elements de control a la execució. + +0.4.4 β (19/02/2023) +Inclosa la utilitat de fer estadistiques dels reblogs i enviar missatge als dos més actius. (opcional) +També fa un missatge amb el tut més compartit (l'assenyala amb una resposta) + +0.4.6 β (11/03/2023) +La utilitat de benvinguda arreplegar l'enllaç per recorrer tots els seguidors. +Així fa un missatge de comiat als seguidors que s'en van. +Afegida la funció d'enviar un correu (afegir a cfg) quan detecte errades. +Primer intent de que converse. + +0.4.8 β (25/03/2023) +Afegit bot_plus_utils que agrupa algunes utilitats cli per a l'administrador. +Afegit l'enllaç a l'article del bloc de la font de bot_plus +Ampliades les estadítiques als favorits. + +0.4.9 β (1/4/2023) +Afegides a les etiquetes els filtres negatius per evitar 'falsos positius'. + +0.5.2 β (14/04/2023) +fetes funcions per publicar els tuts, les imatges, els favorits i els reblocs +en proves - +estadistica d'instàncies dels seguidors que es publicarà amb les desenes i centenars +estadistica del temps que fa que han publicat un tut els seguidors. Es publica amb el resum setmanal d'impulsos. +dades dels seguidors en fitxer json per a fer més utilitats + +0.5.3 β (23/04/2023) +fet fitxer json de les mencions i fitxer txt amb les darreres quaranta (60)(REVISIO) + +0.5.4 β (23/04/2023) +fet fitxer d'avís d'errada tècnica per evitar desconfiguració i esborrat de fitxers. + +0.5.5 β (07/05/2023) +afegit gràfic per mostrar l'activitat dels seguidors. +afegit gràfic per mostrar impulsos dels seguidors. +afegit generació i actualització automàtica del fitxer json per als impulsos (permet fer gràfics de resum setmanal) + +0.5.6 β (XX/05/2023) + + + +PER FER (?) +Reduir a una connexió de notificacions per impulsos i mencions (estalviarà temps) +Incloure de forma automàtica fitxers json de impulsos i mencions. (permet fer gràfics i altres funcions noves). +Una enquesta mensual, de durada setmanal, sobre el funcionament del bot. (fase 1) +(encara no he conseguit la publicacio de l'enquesta (23-4-2023) +El resultat canviarà les opcions. (fase 2) +Fer un de bon dia i un altre de torn de nit (Descartat de moment) diff --git a/LLEGIU-ME b/LLEGIU-ME new file mode 100644 index 0000000..6867c1e --- /dev/null +++ b/LLEGIU-ME @@ -0,0 +1,38 @@ + +bot plus v0.4.4β + +autor: @bonobo@mastodont.cat + +( β )( α ) + +La utilitat agafa una font xml/rss i fa publicacions a mastodon +Està escrit amb php i utilitza elements de bash de linux. + +Només cal copiar l'estructura de directoris i fitxers al teu ordinador. +La primera part es omplir les variables del fitxer cfg que venen totes +comentades. + +REQUISITS PER AL FUNCIONAMENT +1.- sistema linux per fer-ho correr +2.- tindre instal·lat PHP cli (el faig correr sobre PHP 8.1) +3.- necessita les extensions curl del PHP + +Abans de fer la correr bot_plus cal fer anar la bot_plus_utilitat de manera que +omplirà el registre de les darreres publicacions. D'eixa manera començarà +a publicar només les novetats. + +Si optes per fer correr bot_plus la primera volta farà una publicació amb el temps d'espera +que li indiques en la configuració amb un mínim de 30 segons fins revisar tots els elements +de la font xml. + +Pots configura també la qüantitat, fins a cinc, i les paraules que vols que filtre de les URL +per publicar els continguts únicament les que t'interese (cultura, notícies, esports,...) +només cal que comproves que existeixen a la URL d'on fas o agafes el RSS. + +Per a que vaja de forma regular cal incloure al cron una linia com la següent + +*/20 * * * * root /usr/bin/php -f /les/carpetes/on/es/troba/mastodon-rss-bot-plus/bot_plus.php > /dev/null 2>&1 + +El usuari que cal que el correga és root per a que puga fer el log en la carpeta +de logs del sistema. +Si tries un altre directori pot fer-se amb un usuari sense autoritzacions de superusuari.