Mojolicious::Plugin::ShareHelpers - A Mojolicious Plugin for generate share urls, buttons and meta for Twitter, Facebook, VK, MyMailRU and Google Plus
Perl
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
examples
lib/Mojolicious/Plugin
t
.gitignore
.travis.yml
Build.PL
Changes
MANIFEST
MANIFEST.SKIP
META.yml
Makefile.PL
README.pod

README.pod

NAME

Mojolicious::Plugin::ShareHelpers - A Mojolicious Plugin for generate share urls, buttons and meta for Twitter, Facebook, VK, 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

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.

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.