Skip to content
This project enable the Gantry templating framework with a component that renders the latest Google+ profile feed within a slider.
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

Google+ Feed Slider - Particle for Gantry

This projects implements a feed slider that fetches post data from an existing Google+ profile. The appearance as well as the data output can be configured via the Gantry templating framework. Moreover, Google+ Feed Slider supports the flexible parameterization of API requests as well as the custom slider styling and rendering. 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

Download

Choose the correct download for your target platform. The Joomla Plugin System is supported for all Gantry themes globally or locally for the templates Helium and Hydrogen. The latest Particle version is v1.0.3.


Default Particle: English / German

Legacy Particle - Gantry <5.3.2: English / German

Joomla Plugin - All Templates (Global): English / German

Joomla Plugin - Hydrogen: English / German

Joomla Plugin - Helium: English / German


Automatic Installation (Joomla only)

  1. Download the Plugin of the Google Plus Feed Slider Particle for Hydrogen, Helium or Global installation.
  2. Install it over the Joomla Plugin System.
  3. Modify the custom.scss file located under /[GANTRY_THEME]/custom/scss and add the following line @import "gplus-feed-slider"; at the end. Please check the list below to determine where the template folder for your CMS is located.

If you install the plugin globally be aware that the resource location changes to /media/gantry5/engines/nucleus

Manual Installation

  1. Download the Default or Legacy Package of the Google Plus Feed Slider Particle. If you are using Gantry <5.3.2 please use the Legacy Package for compatibility reasons.
  2. Extract the files.
  3. Copy the .html.twig and the .yaml file to your particle folder /[GANTRY_THEME]/custom/particles. Please check the listing below to determine where the template folder for your CMS is located.
  4. Copy the .js file to the folder /[GANTRY_THEME]/custom/js. Create the folder if it does not exist.
  5. Copy the .scss file to the folder /[GANTRY_THEME]/custom/scss. Create the folder if it does not exist.
  6. Modify the custom.scss file located under /[GANTRY_THEME]/custom/scss and add the following line @import "gplus-feed-slider"; at the end.

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 Layout and add the new appearing Particle called Google Plus Feed Slider either globally to your site (base outline), to a specific template or page by dragging it to the designated section.
  3. Get a API Key from the Google API Console. Set your API Key within the Particle backend.
  4. Configure the appearance according to your favor.
  5. [Optional] The download package contains the original version of the Google+ REST API JS file. You can embed it over the backend configuration if you do not want to use the default CDN. If you chose automatic installation the file is already there.

Important: Please be aware that the API Key can always be seen by everyone so you have to restrict the access to both your domain and products (Google+ only). Please create an explicit key for this use case and restrict it appropriately

Supported Parameters and Particle Options

  • Container Attributes
  • Custom CSS Classes for Container
  • Target Profile
  • Number of Posts fetched
  • Slider
    • Auto Slide
    • Slider Scroll Delay
    • Slider Scroll Mode
    • Slider Effects (about 25)
  • Post Configuration
    • Display Name
    • Plus One Counter
    • Slide Number
  • Image configuration
    • Image Size
    • Image Design (Square, Rounded)
    • Image Alt Text
  • Date Configuration (Format, Mode, Delimiters)
  • Button Configuration
    • Different Designs
    • Arrangement Modes
  • Link to Original Post
  • Link Title
    • Link back to Original Post
    • Target Configuration
  • Filtering of Posts with empty Titles
  • Loading Text while fetching Data
  • JS Priority and Placement (head or footer)
  • JS Loading
    • Remote, Local and Default
  • JS Execution
    • Asynchronous
    • Deferred

Showroom

Insight of the Google Plus Feed Slider - Gantry Particle configuration:

Backend (1) - General

1

Backend (2) - Slider

2

Backend (3) - Text

3

Backend (4) - Post

4

Backend (5) - Image

5

Backend (6) - Date

6

Backend (7) - Javascript

7

Example for a basic slider:

Frontend (1) - Slider

8

Future Tasks

  • support more API options usable for slide rendering
  • add more CSS3 slide effects
  • add more languages

Known Issues

None

Dependencies

Google+ REST API

Gantry Framework

Credits

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

Thanks to Google for the Google Plus Platform API.

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.