This module adds the favicons generated by
RealFaviconGenerator to your site. The
responsive name comes from the fact that many devices are catered for including
iPhone, Android, iPad, other tablets and desktops.
Requirements
- Favicon files generated by https://realfavicongenerator.net/
- HTML code generated by https://realfavicongenerator.net/
Installation
- Install this module using the official Backdrop CMS instructions at
https://docs.backdropcms.org/documentation/extend-with-modules. - Prepare your icon file, either an SVG or a PNG, with a square icon with
minimum size of 512x512px. - Go to https://realfavicongenerator.net/ and upload your icon.
- Adjust the settings for each icon type to your preference.
- When asked for the 'Favicon path' leave it as '/' (the root of your
website); this is because this modules will rewrite the URLs based on the
Backdrop public file system path and your preferences in the module. - Click to 'Download your favicon package'.
- Copy the HTML code section to your clipboard; it is a good idea to save this
to a text file and keep with the zip file. - Visit Administration > Configuration > User interface > Responsive favicons
(/admin/config/user-interface/responsive_favicons), paste in the HTML you
copied and upload the zip file you downloaded.
You site will now output the required metadata for the favicons to work. You can
always check the status report page to find out if your site has been correctly
configured.
Advanced installation
Despite the headers saying where to find the files, some clients will look for
these at the root. This module can intercept these requests for files that are
managed by this module (this varies over time as client systems change).
However, the default Backdrop .htaccess
file at the Backdrop root prevents
this for the favicon.ico
file. To enable this module to serve the
favicon.ico
file from the defined location you need to comment out the
following line:
RewriteCond %{REQUEST_URI} !=/favicon.ico
so it looks like this:
# RewriteCond %{REQUEST_URI} !=/favicon.ico
Current Maintainers
- Martin Price - System Horizons Ltd
- Collaboration and co-maintainers welcome!
Credits
Ported to Backdrop by biolithic
This module is based on the
Responsive Icons module for Drupal,
originally written and maintained by a large number of contributors, including:
Drupal development sponsored by Catalyst IT
This entire module was spawned from a blog post on the topic located at
https://www.pixelite.co.nz/article/adding-apple-android-favicons-drupal
License
This project is GPL v2 software. See the LICENSE.txt file in this directory for
complete text.