facebook_share_link 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2012 YOURNAME
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# Facebook Share Link
+
+Builds a link to share something to Facebook based on the Facebook Feed Dialog: http://developers.facebook.com/docs/reference/dialogs/feed/
+
+## Reason for being
+
+I needed this to put facebook share links in emails where the javascript facebook dialogs aren't available.
+
+## Install
+
+<pre>gem install facebook_share_link</pre>
+
+Or add <pre>gem 'facebook_share_link'</pre> to your Gemfile
+
+## Usage
+
+### Mininum
+
+<pre>
+FacebookShareLink.link(
+  app_id: 11111111111, 
+  redirect_uri: "http://yoursite.com/return")
+</pre>
+
+### Full usage
+
+<pre>
+FacebookShareLink.link(
+  app_id: 11111111, 
+  link: "https://github.com/joshcrews", 
+  description: "Josh Crews on Github",
+  message: "I just found Josh Crews on Github",
+  picture: "http://joshcrews.com/logo.png", 
+  caption: "Josh Crews dot Com",
+  redirect_uri: "http://google.com/q=Josh Crews"
+)
+</pre>
+
+#### Outputs
+
+<pre>http://www.facebook.com/dialog/feed?app_id=11111111&caption=Josh+Crews+dot+Com&description=Josh+Crews+on+Github&link=https%3A%2F%2Fgithub.com%2Fjoshcrews&message=I+just+found+Josh+Crews+on+Github&picture=http%3A%2F%2Fjoshcrews.com%2Flogo.png&redirect_uri=http%3A%2F%2Fgoogle.com%2Fq%3DJosh+Crews</pre>
+
+Note: that link won't work because that's a made up app_id

data/lib/facebook_share_link/version.rb

@@ -0,0 +1,3 @@
+module FacebookShareLink
+  VERSION = "0.0.1"
+end

data/lib/facebook_share_link.rb

@@ -0,0 +1,29 @@
+module FacebookShareLink
+  
+  def FacebookShareLink.link(options)
+    raise FacebookShareLinkError, 'Missing app_id' if options[:app_id].nil? || options[:app_id] == ""
+    raise FacebookShareLinkError, 'Missing redirect_uri' if options[:redirect_uri].nil? || options[:redirect_uri] == ""
+    
+    facebook_dialog_path = "http://www.facebook.com/dialog/feed?"
+    
+    queries = options.collect do |key, value|
+                to_query(key, value.to_s)
+              end.sort * '&'
+    
+    facebook_dialog_path + queries
+  end
+  
+  private
+  
+  ## FYI, copied and modded from Rails core
+  def FacebookShareLink.to_query(key, value)
+    require 'cgi' unless defined?(CGI) && defined?(CGI::escape)
+    "#{CGI.escape(key.to_s)}=#{CGI.escape(value.to_s)}"
+  end
+  
+end
+
+class FacebookShareLinkError < StandardError
+end
+
+

data/spec/facebook_share_link_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe FacebookShareLink do
+  
+  def standard_parameters
+    {
+      app_id: 11111111, 
+      link: "https://github.com/joshcrews", 
+      description: "Josh Crews on Github",
+      message: "I just found Josh Crews on Github",
+      picture: "http://joshcrews.com/logo.png", 
+      caption: "Josh Crews dot Com",
+      redirect_uri: "http://google.com/q=Josh Crews"
+    }
+  end
+  
+  it "builds a link to share on facebook" do
+    facebook_share_url = FacebookShareLink.link(standard_parameters)
+    facebook_share_url.should == "http://www.facebook.com/dialog/feed?app_id=11111111&caption=Josh+Crews+dot+Com&description=Josh+Crews+on+Github&link=https%3A%2F%2Fgithub.com%2Fjoshcrews&message=I+just+found+Josh+Crews+on+Github&picture=http%3A%2F%2Fjoshcrews.com%2Flogo.png&redirect_uri=http%3A%2F%2Fgoogle.com%2Fq%3DJosh+Crews"
+  end
+  
+  it "tells you if missing app_id" do    
+    lambda do
+      facebook_share_url = FacebookShareLink.link(standard_parameters.merge(app_id: nil))
+    end.should raise_error(FacebookShareLinkError, 'Missing app_id')
+  end
+  
+  it "tells you if missing redirect_uri" do
+    lambda do
+      facebook_share_url = FacebookShareLink.link(standard_parameters.merge(redirect_uri: nil))
+    end.should raise_error(FacebookShareLinkError, 'Missing redirect_uri')
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper.rb"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+
+require 'facebook_share_link'
+  
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: facebook_share_link
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Josh Crews
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-21 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: &70136969928300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70136969928300
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70136969927600 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70136969927600
+description: Great for adding share on Facebook links in emails
+email:
+- josh@joshcrews.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/facebook_share_link/version.rb
+- lib/facebook_share_link.rb
+- MIT-LICENSE
+- README.md
+- spec/facebook_share_link_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/joshcrews/facebook_share_link
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -706711382868041378
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -706711382868041378
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Builds a URL to create a hyperlink to share something to facebook through
+  the Feed Dialog API
+test_files:
+- spec/facebook_share_link_spec.rb
+- spec/spec_helper.rb