97 lines
2.3 KiB
Markdown
97 lines
2.3 KiB
Markdown
# Widget Ghost
|
||
|
||
## 1. Code Injection (une seule fois)
|
||
|
||
Dans **Ghost Admin → Settings → Code injection → Site Header**, coller tout le contenu de `ghost-inject.html`.
|
||
|
||
Mettre à jour l'URL de l'API en haut du script :
|
||
|
||
```js
|
||
var API_URL = 'https://torrent-api.monsite.com';
|
||
```
|
||
|
||
---
|
||
|
||
## 2. Utilisation dans les articles
|
||
|
||
Dans l'éditeur Ghost, insérer un bloc **HTML** et coller l'un des snippets suivants.
|
||
|
||
### Layout compact (vertical)
|
||
|
||
```html
|
||
<div class="torrent-indicator"
|
||
data-hash="3b245504cf5f11bbdbe1201cea6a6bf45aee1bc0"
|
||
data-label="Ubuntu 24.04 LTS"></div>
|
||
```
|
||
|
||
### Layout large (horizontal, centré)
|
||
|
||
```html
|
||
<div class="torrent-indicator"
|
||
data-hash="3b245504cf5f11bbdbe1201cea6a6bf45aee1bc0"
|
||
data-label="Ubuntu 24.04 LTS"
|
||
data-layout="wide"></div>
|
||
```
|
||
|
||
### Via lien magnet
|
||
|
||
```html
|
||
<div class="torrent-indicator"
|
||
data-magnet="magnet:?xt=urn:btih:3b245504cf5f11bbdbe1201cea6a6bf45aee1bc0&dn=ubuntu"
|
||
data-label="Ubuntu 24.04 LTS"
|
||
data-layout="wide"></div>
|
||
```
|
||
|
||
---
|
||
|
||
## Attributs disponibles
|
||
|
||
| Attribut | Requis | Description |
|
||
|---|---|---|
|
||
| `data-hash` | Oui* | Info hash hexadécimal (40 caractères) |
|
||
| `data-magnet` | Oui* | Lien magnet complet |
|
||
| `data-label` | Non | Titre affiché dans l'en-tête du widget |
|
||
| `data-layout` | Non | `wide` pour le layout horizontal |
|
||
|
||
*`data-hash` ou `data-magnet`, l'un des deux est obligatoire.
|
||
|
||
---
|
||
|
||
## Valeurs retournées
|
||
|
||
### Santé (`health`)
|
||
|
||
| Valeur | Condition |
|
||
|---|---|
|
||
| `dead` | 0 seeder |
|
||
| `poor` | ratio seeders/(seeders+leechers) < 20 % |
|
||
| `good` | ratio ≥ 20 % |
|
||
| `excellent` | ratio ≥ 50 % |
|
||
|
||
### Popularité (`popularity`)
|
||
|
||
| Valeur | Total seeders + leechers |
|
||
|---|---|
|
||
| `low` | < 10 |
|
||
| `moderate` | 10 – 99 |
|
||
| `popular` | 100 – 999 |
|
||
| `viral` | ≥ 1 000 |
|
||
|
||
---
|
||
|
||
## Cache et données périmées
|
||
|
||
Le serveur met les résultats en cache 5 minutes. Si les trackers sont temporairement inaccessibles, le widget affiche les dernières données connues avec la mention *données en cache* dans le pied de page, plutôt qu'un message d'erreur.
|
||
|
||
---
|
||
|
||
## API publique JavaScript
|
||
|
||
```js
|
||
// Rafraîchir tous les widgets de la page
|
||
TorrentIndicator.refreshAll();
|
||
|
||
// Initialiser un élément spécifique
|
||
TorrentIndicator.init(document.querySelector('.torrent-indicator'));
|
||
```
|