Installation

• Install command
• Upgrading from an earlier release
• Configuration
• URL Mappings
• Blogger configuration
• Configuration properties
• Further Documentation
• Contribute

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

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

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

• http://www.blogger.com
• http://code.google.com/apis/blogger
• http://code.google.com/apis/blogger/docs/2.0/developers_guide.html

• http://oauth.net
• http://code.google.com/apis/gdata/docs/auth/oauth.html
• http://www.grails.org/plugin/oauth

• http://www.grails.org/URL+mapping

Contribute

• http://wiki.github.com/acampbell3000/grails-blogger

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

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.