NAME

HTML::SocialMeta - Module to generate Social Media Meta Tags,

VERSION

Version 0.6

SYNOPSIS

    use HTML::SocialMeta;
    # summary or featured image card setup
    my $social = HTML::SocialMeta->new(
        site => '',
        site_name => '',
        title => '',
        description => '',
        image	=> '',
        fb_app_id => '',
	url  => '',  # optional
        ... => '',
        ... => '',
    );

    # returns meta tags for all providers	
    # additional options 'featured_image',  'app', 'player'   
    my $meta_tags = $social->create('summary');

    # returns meta tags specificly for a single provider
    my $twitter_tags = $social->twitter;
    my $opengraph_tags = $social->opengraph;

    my $twitter = $social->twitter;
    my $twitter->create('summary');
    
    # Alternatively call a card directly
    my $summary_card = $meta_tags->twitter->create_summary;
    
    ....
    # You then need to insert these meta tags in the head of your html, 
    # one way of implementing this if you are using Catalyst and Template Toolkit would be ..
    
    # controller 
    $c->stash->{meta_tags} = $meta_tags;
    
    # template
    [% meta_tags | html %]

DESCRIPTION

This module generates social meta tags.

i.e $social->create('summary') will generate:

<meta name="twitter:card" content="summary"/>
<meta name="twitter:site" content="@example_twitter"/>
<meta name="twitter:title" content="You can have any title you wish here"/>
<meta name="twitter:description" content="Description goes here may have to do a little validation"/>
<meta name="twitter:image" content="www.urltoimage.com/blah.jpg"/>
<meta property="og:type" content="thumbnail"/>
<meta property="og:title" content="You can have any title you wish here"/>
<meta property="og:description" content="Description goes here may have to do a little validation"/>
<meta property="og:url" content="www.someurl.com"/>
<meta property="og:image" content="www.urltoimage.com/blah.jpg"/>
<meta property="og:site_name" content="Example Site, anything"/>
<meta property="fb:app_id" content="123433223543"/>'

It allows you to optimize sharing on several social media platforms such as Twitter, Facebook, Google+ and Pinerest by defining exactly how titles, descriptions, images and more appear in social streams.

It generates all the required META data for the following Providers:

* Twitter
* OpenGraph

This module currently allows you to generate the following meta cards:

$social->create()  $twitter->create_       $opengraph->create_  	
summary            summary                 thumbnail         	
featured_image     summary_large_image     article            	 
player             player                  video              	
app                app                     product

SUBROUTINES/METHODS

Constructor

Returns an instance of this class. Requires $url as an argument;

card: OPTIONAL - if you always want the same card type you can set it
site: The Twitter @username the card should be attributed to. Required for Twitter Card analytics.
site_name: This is Used by Facebook, you can just set it as your organisations name.
title: The title of your content as it should appear in the card
description: A description of the content in a maximum of 200 characters
image: A URL to a unique image representing the content of the page
url: OPTIONAL OPENGRAPH - allows you to specify an alternative url link you want the reader to be redirected
player: HTTPS URL to iframe player. This must be a HTTPS URL which does not generate active mixed content warnings in a web browser
player_width: Width of IFRAME specified in twitter:player in pixels
player_height: Height of IFRAME specified in twitter:player in pixels
operating_system: IOS or Android
app_country: UK/US ect
app_name: The applications name
app_id: String value, and should be the numeric representation of your app ID in the App Store (.i.e. 307234931)
app_url: Application store url - direct link to App store page
fb_app_id: This field is required to use social meta with facebook, you must register your website/app/company with facebook. They will then provide you with a unique app_id.

Summary Card

The Summary Card can be used for many kinds of web content, from blog posts and news articles, to products and restaurants. It is designed to give the reader a preview of the content before clicking through to your website.

,-----------------------------------,
|   TITLE                 *-------* |
|                         |       | |
|   DESCRIPTION           |       | |
|                         *-------* |
*-----------------------------------*

Returns an instance for the summary card:

$meta->create('summary');
# call meta provider specifically
$card->twitter->create_summary;
$card->opengraph->create_thumbnail;

fields required:

* card   
* site_name - OpenGraph
* site - Twitter Site
* title
* description
* image

Featured Image Card

The Featured Image Card features a large, full-width prominent image. It is designed to give the reader a rich photo experience, clicking on the image brings the user to your website.

,-----------------------------------,
| *-------------------------------* |
| |                               | |
| |                               | |
| |                               | |
| |                               | |
| |                               | |
| |                               | |
| *-------------------------------* |
|  TITLE                            |
|  DESCRIPTION                      |
*-----------------------------------*

Returns an instance for the featured image card:

$card->create('featured_image');	
# call meta provider specifically
$card->twitter->create_featured_image;
$card->opengraph->create_article;

Fields Required:

* card - Twitter
* site - Twitter
* site_name  - Open Graph
* creator - Twitter
* title
* image
* url - Open Graph

Player Card

The Player Card allows you to share Video clips and audio stream.

,-----------------------------------,
| Title                             |	
| link   				|
| *-------------------------------* |
| |                               | |
| |                               | |
| |                               | |
| |            <play>             | |
| |                               | |
| |                               | |
| *-------------------------------* |
*-----------------------------------*

Returns an instance for the player card:

$card->create('player');	
# call meta provider specifically
$card->twitter->create_player;
$card->opengraph->create_video;

Fields Required:

* site 
* title 
* description 
* image 
* player                
* player_width           
* player_height

image to be displayed in place of the player on platforms that does not support iframes or inline players. You should make this image the same dimensions as your player. Images with fewer than 68,600 pixels (a 262 x 262 square image, or a 350 x 196 16:9 image) will cause the player card not to render. Image must be less than 1MB in size

App Card

The App Card is a great way to represent mobile applications on Social Media Platforms and to drive installs.

,-----------------------------------,
|   APP NAME              *-------* |
|   APP INFO              |  app  | |
|                         | image | |
|                         *-------* |
|   DESCRIPTION                     |
*-----------------------------------*

Return an instance for the provider specific app card:

$card->create('app);	
# call meta provider specifically
$card->twitter->create_app;
$card->opengraph->create_product;

Fields Required

* site
* title
* description
* operatingSystem   
* app_country      
* app_name        
* app_id           
* app_url

create

Create the Meta Tags - this returns the meta information for all the providers:

    * Twitter
    * OpenGraph
    * Google

You just need to specify the card type on create

#'summary', 'featured_image', 'app', 'player'
$social->create('summary');

required_fields

Returns a list of fields that are required to build the meta tags

$social = HTML->SocialMeta->new();
# @fields = qw{}
my @fields = $social->required_fields('summary');

BUGS AND LIMITATIONS

Please report any bugs at http://rt.cpan.org/.

Add support for Schema.org Rich Snippets Improve Unit Tests Add support for additional card types

DEPENDENCIES

Moo - Version 1.001000, List::MoreUtils - Version 0.413

DIAGNOSTICS

A. Twitter Validation Tool

https://dev.twitter.com/docs/cards/validation/validator

Before your cards show on Twitter, you must first have your domain approved. Fortunately, it's a super-easy process. After you implement your cards, simply enter your sample URL into the validation tool. After checking your markup, select the "Submit for Approval" button.

B. Facebook Debugger

https://developers.facebook.com/tools/debug

You do not need prior approval for your meta information to show on Facebook, but the debugging tool they offer gives you a wealth of information about all your tags and can also analyze your Twitter tags.

C. Google Structured Data Testing Tool

http://www.google.com/webmasters/tools/richsnippets

Webmasters traditionally use the structured data testing tool to test authorship markup and preview how snippets will appear in search results, but you can also use see what other types of meta data Google is able to extract from each page.

AUTHOR

Robert Acock <ThisUsedToBeAnEmail@gmail.com> Robert Haliday <robh@cpan.org>

CONFIGURATION AND ENVIRONMENT

INCOMPATIBILITIES

LICENSE AND COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of the the Artistic License (2.0). You may obtain a copy of the full license at:

http://www.perlfoundation.org/artistic_license_2_0

Any use, modification, and distribution of the Standard or Modified Versions is governed by this Artistic License. By using, modifying or distributing the Package, you accept this license. Do not use, modify, or distribute the Package, if you do not accept this license.

If your Modified Version has been derived from a Modified Version made by someone other than you, you are nevertheless required to ensure that your Modified Version complies with the requirements of this license.

This license does not grant you the right to use any trademark, service mark, tradename, or logo of the Copyright Holder.

This license includes the non-exclusive, worldwide, free-of-charge patent license to make, have made, use, offer to sell, sell, import and otherwise transfer the Package with respect to any patent claims licensable by the Copyright Holder that are necessarily infringed by the Package. If you institute patent litigation (including a cross-claim or counterclaim) against any party alleging that the Package constitutes direct or contributory patent infringement, then this Artistic License to you shall terminate on the date that such litigation is filed.

Disclaimer of Warranty: THE PACKAGE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS IS' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES. THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT ARE DISCLAIMED TO THE EXTENT PERMITTED BY YOUR LOCAL LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER OR CONTRIBUTOR WILL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

To install HTML::SocialMeta, copy and paste the appropriate command in to your terminal.

cpanm

cpanm HTML::SocialMeta

CPAN shell

perl -MCPAN -e shell
install HTML::SocialMeta

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)