Grails Blogger Plug-in

  • Tags : blog, blogger
  • Latest : 0.0.4
  • Last Updated: 13 November 2010
  • Grails version : 1.3.4 > *
  • Authors : Anthony Campbell (acampbell3000)
0 vote
Dependency :
compile ":blogger:0.0.4"

Documentation

Summary

Installation

Installation

Install Command

To install the Grails Blogger plug-in type in this command in your project's root folder:

grails install-plugin blogger

Upgrading from an earlier release

There shouldn't be any issues upgrading from an earlier release.

Configuration

Before running your application with the Blogger plug-in, make sure you perform the following configuration steps.

URL Mappings

Once installed your new contact form will be available at the following URL:

http://{HOSTNAME}:{PORT}/{APPLICATION-NAME}/blogger

The Blogger plug-in implements a RESTful style URL which is not configured by default in the downloaded binary. Therefore, you must update your grails-app/conf/UrlMappings.groovy to include the following mapping block:

"/blog/list/feed/$feed" {
    controller = "blog"
    action = "list"
}

"/post/list/$blogId" { controller = "post" action = "list" }

"/post/list/$blogId/feed/$feed" { controller = "post" action = "list" }

"/post/ajaxList/$blogId" { controller = "post" action = "ajaxList" }

"/post/ajaxList/$blogId/feed/$feed" { controller = "post" action = "ajaxList" }

Blogger configuration

The next step is to provide the Blogger plug-in your Google Blogger account details, and the Google Blogger OAuth URLs. These details should be inserted into the grails-app/conf/Config.groovy file. The following shows an example Blogger configuration block:

blogger {
    // Required
    username = "joe.bloggs@gmail.com"
    password = "password"
    maxResults = 500

// Optional max = 10 maxSteps = 5 maxKeywords = 100 maxComments = 10 maxCommentSteps = 5 showPrivateBlogs = false showPrivatePosts = false allowComments = true allowCache = true cacheTimeout = 86400000 backgroundRetrieveLimit = 5

// Feeds rssManagingEditor = "Joe Bloggs" }

oauth { blogger { requestTokenUrl = "https://www.google.com/accounts/OAuthGetRequestToken" accessTokenUrl = "https://www.google.com/accounts/OAuthGetAccessToken" authUrl = "https://www.google.com/accounts/OAuthAuthorizeToken?hd=default" scope = "http://www.blogger.com/feeds" consumer.key = "anonymous" consumer.secret = "anonymous" signed = true } }

Configuration properties

  • username - Your Google Blogger username.
  • password - Your Google Blogger password.
  • maxResults - The maximum number of results to be returned when performing queries. This is used when making requests through the tag controller.
  • max - The maximum number of listing displayed per page.
  • maxSteps - The maximum number of steps displayed in the pagination block.
  • maxKeywords - The maximum number of keywords displayed in the tag listing result set.
  • maxComments - The maximum number of comments displayed in the show photo view.
  • maxCommentSteps - The maximum number of steps displayed in the comment pagination block.
  • showPrivateBlogs - Whether to include private blogs in all blog requests.
  • showPrivatePosts - Whether to include private posts in all post requests.
  • allowComments - Allow users to post photo comments.
  • allowCache - Stores locally the responses returned from the Google Blogger web service. Reduces web service calls to the Google GData API and increases performance.
  • cacheTimeout - How long the cache is valid before being purged.
  • backgroundRetrieveLimit - Used by the background thread to limit the number of previous and subsequent photos retrieved.
  • rssManagingEditor - Name of author managing the RSS feed.

Further Documentation

The blogger plug-in is driven through the Google Blogger API. For additional configuration and feature information please refer to the following documentation: For further information regarding OAuth please refer to the following documentation: For further information regarding URL mapping please refer to the following documentation:

Contribute

If you wish to contribute to the project you can find the latest source code on GitHub:

Description

Description

A simple plug-in which provides a photo gallery driven through the Google Blogger API.

The plug-in only requires the user's Google Blogger account credentials which will instantly pull down all the available public blogs and posts and display the relevant listings. The views are also generate from the "remote-forms" skin provided by the Grails Skin Loader plug-in. This will scaffold Ajax based forms which provides a smoother experience when traversing through an album.

The views don't contain any JavaScript visual effects allowing the developer to integrate their own effects as required.

If you find any issues, please submit a bug on JIRA: http://jira.codehaus.org/browse/GRAILSPLUGINS

Please look at the CHANGES file to see what has changed since the last official release.

Configuration

The following shows an example Blogger configuration block which should be inserted into the grails-app/conf/Config.groovy file:

blogger {
    // Required
    username = "joe.bloggs@gmail.com"
    password = "password"
    maxResults = 500

// Optional max = 10 maxSteps = 5 maxKeywords = 100 maxComments = 10 maxCommentSteps = 5 showPrivateBlogs = false showPrivatePosts = false allowComments = true allowCache = true cacheTimeout = 86400000 backgroundRetrieveLimit = 5

// Feeds rssManagingEditor = "Joe Bloggs" }

oauth { blogger { requestTokenUrl = "https://www.google.com/accounts/OAuthGetRequestToken" accessTokenUrl = "https://www.google.com/accounts/OAuthGetAccessToken" authUrl = "https://www.google.com/accounts/OAuthAuthorizeToken?hd=default" scope = "http://www.blogger.com/feeds" consumer.key = "anonymous" consumer.secret = "anonymous" signed = true } }

For more detailed configuration please view the installation tab.