RyanMPierson / grav-plugin-disqus_comments

Disqus Comments Plugin for Grav

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Grav Disqus Comments Plugin

disqus_comments is a Grav plugin and allows Grav to use a Disqus Comments into your pages.

Enabling is very simple. Just install this plugin in the /user/plugins/ folder in your Grav install. By default, the plugin is enabled and provides some default values.

Installation

To install this plugin, just download the zip version of this repository and unzip it under /your/site/grav/user/plugins. Then, rename the folder to disqus_comments.

You should now have all the plugin files under

/your/site/grav/user/plugins/disqus_comments

NOTE: This plugin is a modular component for Grav which requires Grav, the Error and Problems plugins, and a theme to be installed in order to operate.

Usage

Put in the your theme file this example:

{% include 'disqus_comments.html.twig' %}

Here the list of variables available:

  • disqus_comments:
    • shortname
    • title
    • developer
    • identifier
    • url
    • disabled

Default values:

  • title = Page title
  • identifier = Page ID
  • url = Page URL
  • disabled = false

You can setup directly the child page (blog page example) in the headers or directly on /your/site/grav/user/config/disqus_comments.yaml for static configuration:

disqus_comments:
  shortname: disqus_shortname_example
  title: Different title page
  id: page-slug-example

For static configuration in /your/site/grav/user/config/disqus_comments.yaml use this example:

shortname: disqus_shortname_example
developer: false
disabled: false

I suggest to setup only shortname and if you develop in the local environment, in the blog page, for the other variables use a default variables

About

Disqus Comments Plugin for Grav

License:MIT License