34 lines
1.2 KiB
Markdown
34 lines
1.2 KiB
Markdown
|
# Install and use this script
|
|||
|
|
|
|||
|
|
1. Copy the content of `src` into your shaarli instance (at its root with index.php)
|
|||
|
|
2. Copy `tumblr.ini.dev` to `tumblr.ini`
|
|||
|
|
3. Fill the `tumblr.ini`'s variables
|
|||
|
|
|
|||
|
|
```ini
|
|||
|
|
tumblr = xxx.tumblr.com # your tumblr URL (can be another domain if you paid for it)
|
|||
|
|
api_key = xxx # your tumblr's API key (see below)
|
|||
|
|
private = true # if links should be private or public
|
|||
|
|
shaarli_dir = # leave blank if you followed this tutorial, else, the path to shaarli
|
|||
|
|
```
|
|||
|
|
4. Check if you got write right on the folder containing `import.php`
|
|||
|
|
5. Launch : via browser or via command line
|
|||
|
|
|
|||
|
|
### Tumblr API key
|
|||
|
|
|
|||
|
|
You need to register an app in tumblr :
|
|||
|
|
|
|||
|
|
1. Log in your tumblr account
|
|||
|
|
2. Go to https://www.tumblr.com/oauth/apps
|
|||
|
|
3. Click `Register an application`
|
|||
|
|
4. Fill all mandatory fields + `website` (even if it's not marked as mandatory, trust me, it is)
|
|||
|
|
5. You got it ! **OAuth Consumer Key** !
|
|||
|
|
6. Tips : you can find it again in https://www.tumblr.com/settings/apps
|
|||
|
|
|
|||
|
|
|
|||
|
|
### Limitations
|
|||
|
|
|
|||
|
|
Tumblr's API can *only* retrieve 20 × 250 posts (I did the math, it's 5000)
|
|||
|
|
|
|||
|
|
This script does not resume import, so if you got more than 5k posts, it won't work.
|
|||
|
|
|