An open API service indexing awesome lists of open source software.

https://github.com/loveduckie/silverstripe-social-meta-tags

A Silverstripe module for conveniently integrating meta tags for preview thumbnails on social media platforms (e.g. Facebook, Twitter).
https://github.com/loveduckie/silverstripe-social-meta-tags

opengraph silverstripe silverstripe-4 silverstripe-module social-media-tags social-meta-tags social-network social-preview social-share

Last synced: 6 months ago
JSON representation

A Silverstripe module for conveniently integrating meta tags for preview thumbnails on social media platforms (e.g. Facebook, Twitter).

Awesome Lists containing this project

README

          

# silverstripe-social-metadata-tags

**Easily enhance your website's social media presence with automated metadata generation.**

This [SilverStripe](https://silverstripe.org/) module provides a straightforward solution for integrating metadata to ensure seamless sharing previews across social media platforms. The module automatically generates [Open Graph](https://ogp.me/), [Twitter Card](https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/abouts-cards), and other platform-specific metadata tags, ensuring that your website content appears polished and engaging when shared.

Ideal for boosting social media engagement, this module allows you to control the appearance of shared links while being fully customizable and simple to integrate. Improve your website’s visibility and make your links stand out across all major platforms.

---

## Support

Find below some of the features that this module supports.

- **:white_check_mark: Configurable by page type**
- Inject meta data dependent on page types.
- **:white_check_mark: Support for OpenGraph protocol**
- Provides complete support for the [OpenGraph protocol](https://ogp.me/).
- **:white_check_mark: Support for Twitter meta data**
- Provides complete support for all [Twitter social share tags](https://developer.x.com/en/docs/x-for-websites/cards/guides/getting-started).

---

![Social Media Preview Example](https://user-images.githubusercontent.com/692378/160485859-58540384-9ef3-440c-b41f-f3e4ce15663e.png)

---

## Features

- **Automatic Metadata Generation**: Supports Open Graph, Twitter Cards, and more.
- **Customizable**: Easily tailor metadata settings for specific page types and social platforms.
- **Platform Compatibility**: Ensures your content looks great on Facebook, Twitter, LinkedIn, and Pinterest.
- **Developer-Friendly**: Simple to install, configure, and extend.

---

## Requirements

- SilverStripe ^4.0
- [Yarn](https://yarnpkg.com/lang/en/), [Node.js](https://nodejs.org/en/) (6.x or higher), and [npm](https://npmjs.com) (for building frontend assets)

---

## Installation

Install the module via Composer:

```bash
composer require loveduckie/silverstripe-social-meta-tags
```

---

## Usage

Once installed, the module will automatically generate metadata for your pages based on configurable settings. Refer to the [documentation](docs/en/readme.md) for detailed setup and customization instructions.

---

## Documentation

Comprehensive documentation is available to help you get started and customize the module to fit your needs. See the [Documentation README](docs/en/readme.md) for more information.

---

## License

This module is licensed under a 3-clause BSD license. See the [License](license.md) file for details.

---

## Maintainers

- **Luc Shelton**
[lucshelton@gmail.com](mailto:lucshelton@gmail.com)

---

## Bug Tracker

Found a bug? Submit an issue via the [Issues](issues) section of this repository.

Before submitting, please:

1. Search existing issues to avoid duplicates.
2. If it’s a new bug, create a detailed issue describing:
- Steps to reproduce the issue.
- Expected outcome vs. actual behavior.
- Your environment (SilverStripe version, PHP version, OS, installed modules).
- Screenshots or screencasts, if applicable.

For security-related issues, please contact the maintainers directly instead of creating a public issue.

---

## Contribution Guidelines

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a feature branch for your changes.
3. Submit a pull request (PR) with a clear description of the changes.

Please discuss significant changes with the maintainers before submitting a PR.