josefglatz/seo-aspect-ratios

Common aspect ratios for the TYPO3 CMS system package typo3/cms-seo

Installs: 1 957

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 0

Forks: 0

Open Issues: 0

Type:typo3-cms-extension

1.0.1 2020-04-09 11:45 UTC

This package is auto-updated.

Last update: 2020-09-09 15:23:10 UTC


README

Supported TYPO3 versions: 9 LTS

A simple TYPO3 extension which extends the table configuration array for ext:seo (a TYPO3 CMS system extension) related image fields.

Useful for TYPO3 integrators and developers which wants to add common, useful aspect ratios for the opengraph-/twitter image field other than 1.91:1 and free.

This extension maintains common and known aspect ratios for TYPO3 CMS opengraph- and twitter image fields. It is related to an abandoned work-in-progress patch on the TYPO3 review system.

This extension acts also as an example extension how to add more aspect ratios (TYPO3 9.3: Feature #85147 Render SEO Meta Tags In Frontend, Forge Issue)

Overview

Installation

The extension needs to be installed as any other TYPO3 CMS extension:

via Composer

Require extension

composer require josefglatz/seo-aspect-ratios

Require master branch of the extension (for testing latest development state)

composer require --dev josefglatz/seo-aspect-ratios:dev-master

via TYPO3 Extension Repository

Get it from the Extension Manager

Press the “Retrieve/Update” button and search for the extension key seo_aspect_ratios and import the extension from the repository.

Get it from typo3.org:

You can always get current version from http://typo3.org/extensions/repository/view/seo_aspect_ratios/current/ by downloading the zip version. Upload the file afterwards in the Extension Manager.

Configuration

No configuration needed. This extension ships a common set of known real world aspect ratios for SEO related share-images. Please file an issue if you think we have to extend the set of available aspect ratios.

Underlying Research (2018-09)

Facebook
1.91:1 Sharing images: 1,200 x 628 pixels
1.91:1 Sharing links with an image: 1,200 x 628 pixels
9:16   Sharing Stories: 1,080 x 1,920 pixels*
Instagram
1:1    Sharing square images: 1,080 x 1,080 pixels
1.91:1 Sharing horizontal images: 1,080 x 566 pixels
4:5    Sharing vertical images: 1,080 x 1,350 pixels
9:16   Sharing Stories: 1,080 x 1,920 pixels*
Twitter
16:9   Sharing a single image: 1,200 x 675 pixels
16:9   Sharing multiple images: 1,200 x 675 pixels
1.91:1 Sharing links with an image: 800 x 418 pixels
LinkedIn
3:2    Sharing images to Company Page or personal profile: 1,104 x 736 pixels
1.91:1 Sharing links with an image to Company Page or personal profile: 1,200 x 628 pixels
Pinterest
2:3    Sharing images: 800 x 1,200 pixels
Google+
1.91:1 Sharing images or links with an image: 1,200 x 628 pixels
Snapchat
9:16   Sharing images: 1,080 x 1,920 pixels*

Thanks to

Open-Source is all about community and support! I want to thank everyone who contributed reports, feedback on any channel and code!