=encoding UTF-8 =head1 NAME Mojolicious::Plugin::ShareHelpers - A Mojolicious Plugin for generate share urls, buttons and meta for Twitter, Facebook, Google Buzz, VKontakte, MyMailRU and Google Plus =head1 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 'buzz', url => $url, text => $text, image => $image %>">Share to Google Buzz</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 'buzz', url => 'http://mojolicio.us', text => 'Viva la revolution', image => 'http://mojolicious.org/webinabox.png', type => 'normal-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 =head1 DESCRIPTION L<Mojolicous::Plugin::ShareHelpers> is a plugin for generate share url, share button and share meta (Twitter, Facebook, VKontakte). Plugin adds a C<share_url>, C<share_button>, C<share_meta> and C<is_share_agent> helpers to L<Mojolicious>. =head1 SHARE API =over 5 =item * Twitter Share L<http://dev.twitter.com/pages/tweet_button> =item * Facebook Share L<http://developers.facebook.com/docs/share> =item * Google Buzz Share L<http://www.google.com/buzz/api/admin/configPostWidget> =item * VKontakte Share L<http://vkontakte.ru/pages.php?act=share> =item * MyMailRU Share L<http://api.mail.ru/sites/plugins/share/extended/> =item * Google Plus L<http://code.google.com/intl/ru-RU/apis/+1button/> =back =head1 METHODS L<Mojolicious::Plugin::ShareHelpers> inherits all methods from L<Mojolicious::Plugin> and implements the following new ones. =head2 C<register> $plugin->register; Register plugin hooks in L<Mojolicious> application. =head1 SEE ALSO L<Mojolicious>, L<Mojolicious::Guides>, L<http://mojolicious.org>. =head1 AUTHOR Anatoly Sharifulin <sharifulin@gmail.com> =head1 BUGS Please report any bugs or feature requests to C<bug-mojolicious-plugin-sharehelpers at rt.cpan.org>, or through the web interface at L<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. =over 5 =item * Github L<http://github.com/sharifulin/Mojolicious-plugin-sharehelpers/tree/master> =item * RT: CPAN's request tracker L<http://rt.cpan.org/NoAuth/Bugs.htMail?Dist=Mojolicious-plugin-sharehelpers> =item * AnnoCPAN: Annotated CPAN documentation L<http://annocpan.org/dist/Mojolicious-plugin-sharehelpers> =item * CPANTS: CPAN Testing Service L<http://cpants.perl.org/dist/overview/Mojolicious-plugin-sharehelpers> =item * CPAN Ratings L<http://cpanratings.perl.org/d/Mojolicious-plugin-sharehelpers> =item * Search CPAN L<http://search.cpan.org/dist/Mojolicious-plugin-sharehelpers> =back =head1 COPYRIGHT & LICENSE Copyright (C) 2010-2011 by Anatoly Sharifulin. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. =cut