79 lines
1.8 KiB
Markdown
79 lines
1.8 KiB
Markdown
# 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
|
|
<?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`:
|
|
```php
|
|
$author_handle = 'tuoaccount@tuaistanza.it';
|
|
```
|
|
|
|
## Debug
|
|
|
|
Per attivare i log in console:
|
|
```php
|
|
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 |