helmich / neos-disqus
Add Disqus discussions to your site
Installs: 23
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Language:HTML
Type:typo3-flow-package
Requires
- typo3/flow: *
- typo3/neos: *
- typo3/typoscript: *
This package is auto-updated.
Last update: 2020-01-27 18:47:28 UTC
README
This is a TYPO3 Neos plugin that integrates Disqus discussions into your site (in case you're -- like me -- too lazy to implement your own commenting system in Neos).
Setup
Requirements
Tested with TYPO3 Neos 1.2. Should work with other releases too, though.
Installation
Composer. Easy.
composer require helmich/disqus
Integration as individual content element
You can insert a Disqus discussion as an individual content element. It is listed under "Plugins" when inserting a new content element.
The "comment" content element is not inline-editable. There are two options you can change using the inspector, though:
-
Site name. This is your short site name under which your site is registered at Disqus. When including more discussion elements, it might be a good idea to leave this empty and set this value via TypoScript (see below for that).
-
Thread identifier. The identifier that is used for the comment thread. When left empty, the node identifier of the nearest document node will be used as a discussion identifier (which is a quite sensible default that should work in most cases).
When integrating more than a few discussions, it will become tedious to configure your site name for each one individually. You can override the site name using TypoScript:
page {
prototype(Helmich.Disqus:Discussion) {
shortname = 'your-site-name'
}
}
Integrate Disqus on all pages
You can use this plugin to integrate Disqus discussions on all (or a subset) of all pages using TypoScript:
page = TYPO3.Neos:Page {
// Other definitions...
body {
parts {
discussion = Helmich.Disqus:Discussion {
// Override template if necessary:
// templatePath = '...'
// Override site name if necessary:
// shortname = 'your-site-name'
}
}
}
}
Inside your page fluid template, then simply render the content element:
{parts.discussion -> f:format.raw()}
Integrate comment count
You can also integrate a comment count in overview pages. Simply insert an
object of type Helmich.Disqus:Count
anywhere in your page, and add an
data-disqus-identifier
attribute to your links.
page = TYPO3.Neos:Page {
// Other definitions
footer {
disqusCount = Helmich.Disqus:Count {
shortname = 'your-site-name'
}
}
}
In template:
<a href="{neos:uri.node(node: myPage, section='disqus_thread'}" data-disqus-identifier="{myPage.identifier}">
0 Comments
</a>