https://github.com/omardelarosa/tumblrizr
A jQuery plugin for pilfering content from any Tumblr using AJAX.
https://github.com/omardelarosa/tumblrizr
Last synced: 3 months ago
JSON representation
A jQuery plugin for pilfering content from any Tumblr using AJAX.
- Host: GitHub
- URL: https://github.com/omardelarosa/tumblrizr
- Owner: omardelarosa
- Created: 2013-11-06T04:35:51.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2013-11-07T17:09:42.000Z (about 12 years ago)
- Last Synced: 2024-12-28T22:19:53.197Z (11 months ago)
- Language: JavaScript
- Homepage: omardelarosa.com/tumblrizr
- Size: 125 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
#Tumblrizr
Tumblrizr is a jQuery plugin that allows you to fetch the content from your Tumblr pages and plug it directly into your own website's pages using AJAX. To use it in your pages, just download either of the following:
###[Development Version 0.1 ](http://omardelarosa.com/tumblrizr/tumblrizr.js)
###[Production-ready, Minified Version 0.1](http://omardelarosa.com/tumblrizr/tumblrizr.min.js)
##Usage:
####Step 1:
- Select your target element by ID or class using jQuery.
```
var target_element = $('#id_of_element'),
```
#### Step 2:
- Set your Tumblr content URL (Don't forget to end it in /json).
```
var url_to_tumblr_content = "http://yourname.tumblr.com/staticpage/json";
```
#### Step 2B:
- If you want to set a callback function, set that to a variable:
```
var some_callback = function(e,target){
console.log("I was called by ", target, "and my event object is ",e);
}
```
#### Step 3:
- Call the **.tumblrizr** method of the jQuery-fied target.
```
target_element.tumblrize("http://yourname.tumblr.com/staticpage")
```
- Your Tumblr page's content should then appear inside of your target element.
#### Step 3 (alt):
- Call the **.tumblrizr** method of the jQuery-fied target and pass in your callback function
```
target_element.tumblrize("http://yourname.tumblr.com/staticpage", some_callback)
```
##Viewing Raw Tumblr Data
After appending your Tumblr content to an element, the original Tumblr response is stored in the target element's data store. To access the original data, try this:
```
target_element.data("tumblr_data");
```
Your console should return a JSON-formatted object conaining the original Tumblr response along the lines of:
```
{
"tumblelog": {
"title": "page title goes here",
"description": "",
"name": "your_tumblr_user_name",
"timezone": "US\/Eastern",
"cname": false,
"feeds": [
]
},
"posts": [
{
"id": null,
"url": "",
"url-with-slug": "",
"type": "regular",
"date-gmt": " GMT",
"date": "Wed, 31 Dec 1969 19:00:00",
"bookmarklet": null,
"mobile": null,
"feed-item": "",
"from-feed-id": 0,
"unix-timestamp": 1383682011,
"format": "html",
"reblog-key": "TmN3ujDJ",
"slug": "about",
"regular-title": "about",
"regular-body": "
Some random tumblr body content
"
}
]
};
```
### Fine Print:
This plugin is in no way endorsed or officially related to Tumblr. For more information about using Tumblr data or its API, please visit [their very well-documented API page](http://www.tumblr.com/docs/en/api/v2).