English
资源说明：A gem to add Open Graph metadata to content objects.
## Open Meta Tags: Integrate Web page metadata into the Facebook social graph.
* **Homepage**: [http://intridea.com](http://intridea.com)
* **Git**: [http://github.com/intridea/open-meta-tags](http://github.com/intridea/open-meta-tags)
* **Author**: Jonathan Nelson
* **Contributors**: See Contributors section below
* **Copyright**: 2010
* **License**: MIT License
* **Latest Version**: 0.4.0
* **Release Date**: August 13th 2010
## Synopsis
Open Meta Tags is an Open Graph tool for the Ruby programming language. It enables you to turn normal web pages into meta objects in the graph. Once pages become objects in the graph, users can establish connections to your pages as they do on Facebook Pages. The value of providing structured data through the Open Graph means that your pages will show up richly across Facebook: in user profiles, within search results and in News Feed.
## Requirements
In order to turn web pages into Open Graph objects, you'll need the following in your Rails app:
* Install the Open Meta Tags gem
* `gem 'open-meta-tags', :require => 'open_meta_tags'`
* Add the following html tag:
* ``
* Add Open Meta Tags to your web pages
* See examples below
* [Add the Facebook Like button to your web pages](http://developers.facebook.com/docs/reference/plugins/like)
Feature List
------------
**1.** Turn any web page into meta objects in the Open Graph
These Open Graph tags allow you to specify structured information about your web pages. The more information you provide, the more opportunities your web pages can be surfaced within Facebook today and in the future. Here's an example for a music page:
Day & Age (2008)
...
...
**2.** Define Open Meta Tags in your controller using instance variables:
# Example: example_controller.rb
@page_title = 'Day & Age'
@page_type = 'music'
@page_site_name = 'Amazon'
@page_image = 'http://ecx.images-amazon.com/images/I/61CK4wp-HTL._SL500_AA300_.jpg'
@page_admins = 'USER_ID_GOES_HERE'
@page_app_id_ = 'APP_ID_GOES_HERE'
@page_description = 'Day & Age is the third studio album by American rock band The Killers, released on November 24, 2008 in the UK, Canada and the US.'
**3.** Use Open Meta Tags in your views using the following methods:
# Example: single.html.haml
- content_for :head do
= title 'Day & Age'
= type 'music'
= description 'Day & Age is the third studio album by American rock band The Killers, released on November 24, 2008 in the UK, Canada and the US.'
**4.** Use Open Meta Tags in your view using the `single_meta_tags` method:
# Example: single.html.haml
- content_for :head do
= single_meta_tags :title => 'Day & Age', :type => 'music', :description => 'Day & Age is the third studio album by American rock band The Killers, released on November 24, 2008 in the UK, Canada and the US.'
**5.** Use Open Meta Tags in your view using the `global_meta_tags` method:
# Example: application.html.haml
= global_meta_tags :title => 'The Killers', :type => 'music', :description => 'The Killers are an American Indie band from Las Vegas, Nevada, which formed in 2002. The band consists of Brandon Flowers (vocals, keyboards), Dave Keuning (guitar, backing vocals), Mark Stoermer (bass guitar, backing vocals) and Ronnie Vannucci Jr. (drums, percussion).'
## Options
You can use these options to create Open Graph objects using the `global_meta_tags` or `single_meta_tags` method.
### Basic metadata
* title - The title of your object as it should appear within the graph, e.g., "The Rock".
* type - The type of your object, e.g., "movie". Depending on the type you specify, other properties may also be required.
* image - An image URL which should represent your object within the graph.
* url - The canonical URL of your object that will be used as its permanent ID in the graph, e.g., "http://www.imdb.com/title/tt0117500/".
* description - A one to two sentence description of your object. Limited to 150 characters.
* site_name - If your object is part of a larger web site, the name which should be displayed for the overall site. e.g., "IMDb".
* admins - A comma-separated list of Facebook user IDs that administer the page.
* app_id - A Facebook Platform application ID that administers the page.
### Specifying locations
The Open Graph protocol supports the ability for you to specify location information for your object. This is useful if your object is for a business or anything else with a real-world location. You can specify location via latitude and longitude, a full address, or both. The property names used are defined within the [Microformat hCard](http://microformats.org/wiki/hcard).
In order to specify latitude and longitude, include the following two properties:
* latitude - e.g., "37.33182".
* longitude - e.g., "-122.03118".
If you wish to specify a human readable address, include the following five properties:
* street-address - e.g., "1 Infinite Loop"
* locality - e.g, "Cupertino"
* region - e.g., "CA"
* postal-code e.g., "95014"
* country-name - e.g., "USA"
**This:**
# Example: single.html.haml
- content_for :head do
= single_meta_tags :street-address => '1 Infinite Loop', :locality => 'Cupertino', :region => 'CA', :postal_code => '95014', :country_name => 'USA'
**Produces:**
### Specifying contact information
The Open Graph protocol supports the ability for you to specify contact information for your object. It's likely that future versions of the protocol will support extracting this information from the body of your page. In order to specify contact information, include at least one of the following three properties:
* email - e.g., "john@doe.com".
* phone_number - e.g., "1-800-555-1234".
* fax_number - e.g., "1-800-555-5678".
**This:**
# Example: single.html.haml
- content_for :head do
= single_meta_tags :email => 'john@doe.com', :phone_number => '1-800-555-1234', :fax_number => '1-800-555-5678'
**Produces:**
## Object Types
In order for your object to be represented within the graph, you need to specify its type. This is done using the `:type` property:
**This:**
# Example: single.html.haml
- content_for :head do
= single_meta_tags :type => 'product'
**Produces:**
The base schema includes the following types. It's possible that social networks will choose to support only a subset of these types or create additional types based on their niche.
### Activities
* activity
* sport
### Businesses
* bar
* company
* cafe
* hotel
* restaurant
### Groups
* cause
* sports_league
* sports_team
### Organizations
* band
* government
* non_profit
* school
* university
### People
* actor
* athlete
* author
* director
* musician
* politician
* public_figure
### Places
* city
* country
* landmark
* state_province
### Products and Entertainment
* album
* book
* drink
* food
* game
* movie
* product
* song
* tv_show
For products which have a UPC code or ISBN number, you can specify them using the `:upc` and `:isbn` properties. These properties help to make more concrete connections between graphs.
**This:**
# Example: single.html.haml
- content_for :head do
= single_meta_tags :upc => '123456789012', :isbn => '90-70002-34-5'
**Produces:**
### Websites
* article
* blog
* website
**This:**
# Example: single.html.haml
- content_for :head do
= single_meta_tags :article => 'http://mashable.com/2010/07/16/apple-free-iphone-4-cases/', :blog => 'http://mashable.com'
**Produces:**
## Contributors
* [Jonathan Nelson](http://intridea.com/about/people/jonathan)
* [Jeremy McAnally](http://intridea.com/about/people/jeremy)
## Note on Patches/Pull Requests
* Fork the project.
* Make your feature addition or bug fix.
* Add tests for it. This is important so I don't break it in a
future version unintentionally.
* Commit, do not mess with rakefile, version, or history.
(if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
* Send me a pull request. Bonus points for topic branches.
## Copyright
Copyright (c) 2010 Intridea. See LICENSE for details.
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
