fediverso-box/README.md

Fediverso Box

Plugin WordPress per mostrare un box che permette agli utenti di seguire l'autore nel Fediverso.

Importante: Architettura v2.x

A partire dalla v2.0, il JavaScript è integrato direttamente nel file PHP invece di essere un file separato. Questo garantisce il corretto funzionamento quando il plugin viene inserito dinamicamente nel DOM.

File attivi:

• fediverso-box.php (HTML + JavaScript integrato)
• fediverso-style.css (CSS)

File deprecati:

• legacy/fediverso-script.js (mantenuto solo per riferimento storico)

Caratteristiche

• Form per inserire istanza Mastodon
• Link diretto a fediverso.info per info
• Link per creare account su mastodon.uno
• Validazione input
• Responsive design
• Debug mode attivabile
• JavaScript caricato globalmente (compatibile con inserimento dinamico)

Installazione

1. Carica la cartella fediverso-box in /wp-content/plugins/
2. Attiva il plugin dal pannello WordPress

Utilizzo

Via PHP

<?php if (function_exists('fediverso_box')) { fediverso_box(); } ?>

Via Shortcode

[fediverso_box]

Via Custom Plugin (inserimento dinamico)

Il plugin è compatibile con il sistema universale di inserimento del Custom Plugin.

Configurazione

Modifica l'handle dell'autore in fediverso-box.php:

$author_handle = 'tuoaccount@tuaistanza.it';

Debug

Per attivare i log in console:

define('FEDIVERSO_BOX_DEBUG', true);

Changelog

v2.1 (Current - Production)

• JavaScript integrato nel PHP
• Funzione globale window.initFediversoBox()
• Compatibilità con inserimento dinamico nel DOM
• Debug mode con flag attivabile
• Codice production-ready (nessun log in console)

v1.2 (Legacy)

• JavaScript in file separato
• Funzionamento solo con caricamento statico

Versione

v2.1 (Production)

Autore

Emanuele Gori - https://emanuelegori.uno