Project

pingr

0.0
Low commit activity in last 3 years
A long-lived project that still receives updates
A simple gem for pinging search engines with your XML sitemap
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
 Dependencies

Development

>= 0

Runtime

>= 0
>= 0
 Project Readme

Pingr - Tell search engines about your sitemap changes

Pingr is a super-simple gem built for the blogit project.

Installation

Add this line to your application's Gemfile:

gem 'pingr'

And then execute:

$ bundle

Or install it yourself as:

$ gem install pingr

Usage

From within your app (most likely a controller):

def ping_sitemaps
  Pingr::Request.new(my_sitemap_url) # This will ping Google and Bing
end

A good way to do this would be using Rails's after filters:

class PostsController < ActionController::Base

  after_filter :ping_sitemaps, only: [:create, :update, :destroy]

  # ...

  private

  def ping_sitemaps
    Pingr::Request.new(my_sitemap_url)
  end

end

You can view the supported search engines and add your own by viewing the code in this directory:

https://github.com/Bodacious/pingr/tree/master/lib/pingr/search_engines

Modes

By default, Pingr is set to :test mode, meaning it won't actually perform the requests. If the Rails environment is :production then the mode is set to :live which will perform requests to the search engines.

You can change this by manually setting Pingr.mode

# in config/initializers/pingr.rb
Pingr.mode = :live if Rails.env =~ /staging|production/

NOTE: Search engines may penalise or black-list you if you perform too many requests - they recommend no more than one per hour.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request