tumblr2shaarli/docs/FR.md

1.5 KiB
Raw Blame History

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
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
  1. Vérifier si vous avez les droits en écriture sur la base (datastore.php) et le dossier ou se trouve import.php
  2. 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)