Skip to content
This project contains an advanced favicon tag generation Extension for the Gantry templating framework.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build
platform/joomla
screenshots
src
.gitignore
LICENSE
README.md

README.md

Favicon Tag Generator - Extension for Gantry

This project contains a Gantry Extension and improves the Favicon as well as the Touch Icon Tag Generation and Configuration within the Gantry templating framework. Favicon Tag Generator encapsulates the parameterization of the most common icon sizes, allows the automatic attachment of tags and also has a option to add customized meta information. Furthermore, it provides an easy, user friendly and GUI assisted configuration and integration. In the current revision the following CMSs are supported:

  • Joomla
  • Wordpress
  • Grav

Prerequisites

  • CMS (Joomla, Wordpress, Grav)
  • Gantry Templating Framework and Theme

Deprecation

  • This project might get abandoned in the future because Gantry now supports <head> access over Atoms / Particles #2303.
  • This extension will be completely replaced by the Favicon Tag Generator Atom somewhere in the future.
  • Currently both project support the same functionality and are on the same update level.

Download

Choose the correct download for your target platform. The Joomla Plugin System is supported locally for the Gantry themes Helium and Hydrogen. The latest Extension version is v1.1.3.

Attention: This is an extension of the Gantry core functionality. Hence, the installation overrides (not overwrites) core files of the Gantry Framework. On install you don't lose anything, but changes on the framework might not be propagated until the extension is removed / uninstalled.


Default Extension: English / German

Legacy Extension - Gantry <5.3.2: English / German

Joomla Plugin - Hydrogen: English / German

Joomla Plugin - Helium: English / German


Automatic Installation (Joomla only)

  1. Download the Plugin of the Favicon Tag Generator Extension for Hydrogen or Helium.
  2. Install it over the Joomla Plugin System.

Manual Installation

  1. Download the Default Package of the Favicon Tag Generator Extension.
  2. Extract the files.
  3. Copy the following files to your template folder:
    • page_head.html.twig file to /[GANTRY_THEME]/custom/engine/templates and the
    • assets.yaml file to /[GANTRY_THEME]/custom/engine/blueprints/page.

Please check the listing below to determine where the template folder for your CMS is located.

CMS Template Folder

Please be aware that the template folder path varies in dependence of the used CMS. Here is a list of the folders for the different platforms:

Wordpress

/wp-content/themes/[GANTRY_THEME]

Joomla

/templates/[GANTRY_THEME]

Grav

/user/data/gantry5/themes/[GANTRY_THEME]

Configuration

  1. Go to your Gantry templating backend (e.g. Extensions/Templates).
  2. Switch to Page Settings and check the new controls which were added to the Assets section.
  3. Configure the tag generation according to your favor.

Supported Parameters and Extension Options

  • Different Tag Generation Modes
    • Automatic, Semi-Automatic, Manual, Custom Only
  • Favicon and Touch Icon Tag Generation for many known devices
    • e.g. 16px, 32px, 36px, 48px, 57px, 60px, 72px, 76px, 96px, 114px, 120px, 144px, 150px, 152px, 180px, 192px, 196px, 300px
    • Manifest File
    • Tile Color
    • Theme Color
    • MS Square, MS Wide and MS TileImage
    • Safari Mark Icon
  • Custom Tag Generation for new appearing Icon Sizes

Showroom

Insight of the Favicon Tag Generator - Gantry Extension configuration:

Backend (1) - General

1

Backend (2) - Icons (1)

2

Backend (3) - Icons (2)

3

Backend (4) - Icons (3)

4

Backend (5) - Icons (4)

5

Backend (6) - Custom

6

Future Tasks

  • maintain future <meta> tags
  • add more languages

Known Issues

  • Updates to the Gantry core files might be missing if assets.yaml or page_head.html.twig were changed during an Gantry update. In case of problems simply uninstall the extension.

Dependencies

Gantry Framework

Credits

Thanks to the Gantry team for providing a modern templating framework.

by thex | gantryprojects

Copyright (c) 2018, free to use in personal and commercial software as per the license.

You can’t perform that action at this time.