# Installer et utiliser ce script

  1. Copier le contenu de `src` dans votre instance Shaarli (à sa racine où il y a `index.php`)
  2. Copier `tumblr.ini.dev` vers `tumblr.ini`
  3. Remplir les variables de `tumblr.ini`

```ini
tumblr = xxx.tumblr.com # l'URL de votre tumblr (ça peut être un autre domaine si vous avez payé)
api_key = xxx # votre clef d'API tumblr (voir ci-dessous)
private = true # indique si les liens importés seront privés ou publiques
shaarli_dir = # laisser vide si vous avez suivi ce tuto, sinon, le chemin vers votre instance shaarli
```
  4. Vérifier si vous avez les droits en écriture sur la base (datastore.php) et le dossier ou se trouve `import.php`
  5. Lancer le script via votre navigateur ou par ligne de commande

### La clef d'API Tumblr

Vous avez besoin d'enrigistrer une app Tumblr :
  
  1. Connectez vous sur votre compte tumblr
  2. Allez sur https://www.tumblr.com/oauth/apps
  3. Cliquez sur `Enregistrer une application`
  4. Remplissez tous les champs obligatoires + `website` (même si c'est pas marqué obligatoire, ça l'est)
  5. Vous l'avez votre clef ! **Clé du client (OAuth)** !
  6. Astuce : vous pouvez la retrouver ici : https://www.tumblr.com/settings/apps


### Limitations 

L'API de Tumblr ne peut récupérer *que* 20 × 250 posts (J'ai calculé, ça fait 5000)

Ce script ne permet pas de *compléter* un import depuis un post précis, donc si vous avez plus de 5k posts, ça ne fonctionnera pas (enfin, vous n'aurez pas tout)