NAME

Mojolicious::Plugin::ShareHelpers - A Mojolicious Plugin for generate share urls, buttons and meta for Twitter, Facebook, VKontakte, MyMailRU and Google Plus

SYNOPSIS

# Mojolicious
$self->plugin('share_helpers');

# Mojolicious::Lite
plugin 'share_helpers';

# share urls:
<a href="<%== share_url 'twitter',   url => $url, text => $text, via => 'sharifulin' %>">Share to Twitter</a>
<a href="<%== share_url 'facebook',  url => $url, text => $text %>">Share to Facebook</a>
<a href="<%== share_url 'vkontakte', url => $url %>">Share to ВКонтакте</a>
<a href="<%== share_url 'mymailru',  url => $url %>">Share to Мой Мир</a>

# share buttons:
%== share_button 'twitter',   url => 'http://mojolicio.us', text => 'Viva la revolution!', via => 'sharifulin';
%== share_button 'facebook',  url => 'http://mojolicio.us', type => 'button_count', title => 'Share it';
%== share_button 'vkontakte', url => 'http://mojolicio.us', type => 'round', title => 'Save';
%== share_button 'mymailru',  url => 'http://mojolicio.us', type => 'button_count', title => 'Share to Мой Мир';

# google plus button +1:
%== share_button 'google+', lang => 'ru'
%== share_button 'google+', noscript => 1, size => 'tall', url => 'http://mojolicio.us'

# generate meta for share
%== share_meta title => 'Mojolicious', description => 'Viva la revolition!', url => 'http://mojolicio.us', image => 'http://mojolicious.org/webinabox.png'
%== share_meta title => 'Mojolicious', description => 'Viva la revolition!', url => 'http://mojolicio.us', image => 'http://mojolicious.org/webinabox.png', og => 1, fb_app_id => 1234567890, site_name => 'Site Name'

# check share agent, it may returns string such as 'facebook' or 'twitter' or 'vkontakte' or empty string
%= is_share_agent

DESCRIPTION

Mojolicous::Plugin::ShareHelpers is a plugin for generate share url, share button and share meta (Twitter, Facebook, VKontakte).

Plugin adds a share_url, share_button, share_meta and is_share_agent helpers to Mojolicious.

SHARE API

• Twitter Share http://dev.twitter.com/pages/tweet_button

• Facebook Share http://developers.facebook.com/docs/share

• VK Share http://vk.com/pages.php?act=share

• MyMailRU Share http://api.mail.ru/sites/plugins/share/extended/

• Google Plus http://code.google.com/intl/ru-RU/apis/+1button/

METHODS

Mojolicious::Plugin::ShareHelpers inherits all methods from Mojolicious::Plugin and implements the following new ones.

register

$plugin->register;

Register plugin hooks in Mojolicious application.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicious.org.

AUTHOR

Anatoly Sharifulin <sharifulin@gmail.com>

BUGS

Please report any bugs or feature requests to bug-mojolicious-plugin-sharehelpers at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.htMail?Queue=Mojolicious-plugin-sharehelpers. We will be notified, and then you'll automatically be notified of progress on your bug as we make changes.

• Github

  http://github.com/sharifulin/Mojolicious-plugin-sharehelpers/tree/master

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.htMail?Dist=Mojolicious-plugin-sharehelpers

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Mojolicious-plugin-sharehelpers

• CPANTS: CPAN Testing Service

  http://cpants.perl.org/dist/overview/Mojolicious-plugin-sharehelpers

• CPAN Ratings

  http://cpanratings.perl.org/d/Mojolicious-plugin-sharehelpers

• Search CPAN

  http://search.cpan.org/dist/Mojolicious-plugin-sharehelpers

COPYRIGHT & LICENSE

Copyright (C) 2010-2013 by Anatoly Sharifulin.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.