SEO Tags Helper
Generates Meta Tags for SEO, Facebook Open Graph, Twitter Cards
Table of Contents
- Installation
- Getting Started
- Usage
- Example with ejs
- Configuration Options Reference
- Meta Tags Data Reference
- Contact
Installation
npm i seo-tags-helper
Getting Started
const seoHelper = require('seo-tags-helper')
Usage
seoHelper.print( meta = {}, config = {} )
Returns the constructed HTML Output String, using data specified in meta
.
-
meta
An object containing data for meta tags, values specified here override the default values (if specified)
Refer Here for a list of possible keys for meta
-
config
An object containing configuration options, values specified here override the global configuration
Refer Here for a list of possible configuration options
seoHelper.setConfig( config = {} )
Sets Global Configuration
Refer Here for a list of possible configuration options
seoHelper.setDefault( defaultMeta = {} )
Sets default values for meta tags data, default values are used as fallbacks for keys not specified in seoHelper.print
Refer Here for a list of possible keys for defaultMeta
Example with ejs
const seoHelper = require("seo-tags-helper");
seoHelper.setDefault({ title: "Dummy Title" });
seoHelper.setConfig({ enableRobots: false, enableFacebookOg: false });
module.exports.dummy = (req, res) => {
const metaData = {
title: "Lorem Ipsum",
favicon: "https://picsum.photos/60",
desc: "Lorem ipsum dolor sit amet consectetur adipisicing elit. ",
twitterTitle: "Twitter - Dummy Title",
twitterDesc: "Twitter - Lorem ipsum dolor sit amet consectetur adipisicing elit",
twitterImage: "https://picsum.photos/400",
twitterUrl: "https://www.lipsum.com/",
};
res.render("view", { metaData, seoHelper });
});
};
<!-- View -->
<html>
<head>
<!-- Pass config as the second argument, overrides global config -->
<%- seoHelper.print(metaData, { useGeneralAsDefault: false } ) %>
</head>
<body>
Hello World
</body>
</html>
Configuration Options
Option | Default | Description |
---|
enableGeneral | true | Enable General Meta Tags |
enableFacebookOg | true | Enable Tags for Facebook Open Graph |
enableTwitter | true | Enable Tags for Twitter Cards |
enableRobots | true | Allow / Disallow Robots |
useGeneralAsDefault | true | Use General tags as default for Facebook and Twitter |
Meta Tags Data Reference
Key | Description |
---|
title | Meta Title |
desc | Meta Description |
image | Image to be used for Facebook and Twitter if ogImage or twitterImage is missing and enableGeneralAsDefault is set to true |
imageAlt | Alt Text for Image |
url | Url to be used for Facebook and Twitter if ogUrl or twitterUrl are missing and enableGeneralAsDefault is set to true |
favicon | Link to Favicon Image |
ogTitle | Title to be used for Facebook Open Graph, defaults to title if enableGeneralAsDefault is set to true |
ogType | Type to be used for Facebook Open Graph - article, audio, video etc. |
ogDesc | Description to be used for Facebook Open Graph, defaults to desc if enableGeneralAsDefault is set to true |
ogImage | Image to be used for Facebook Open Graph, defaults to image if enableGeneralAsDefault is set to true |
ogImageAlt | Alt Text for ogImage |
ogUrl | Url to be used for Facebook Open Graph, defaults to url if enableGeneralAsDefault is set to true |
ogFbAppId | Facebook App ID |
twitterTitle | Title to be used for Twitter Card, defaults to title if enableGeneralAsDefault is set to true |
twitterDesc | Description to be used for Twitter Card, defaults to desc if enableGeneralAsDefault is set to true |
twitterUrl | Url to be used for Twitter Card, defaults to url if enableGeneralAsDefault is set to true |
twitterImage | Image to be used for Twitter Card, defaults to image if enableGeneralAsDefault is set to true |
twitterImageAlt | Alt Text for twitterImage |
Contact
