knplabs / knp-disqus-bundle
Installs: 78 533
Dependents: 0
Suggesters: 0
Security: 0
Stars: 62
Watchers: 31
Forks: 16
Open Issues: 6
Type:symfony-bundle
Requires
- php: >=7.2.5
- ext-json: *
- symfony/http-client: ^4.4 || ^5.0 || ^6.0
Requires (Dev)
- phpstan/phpstan: ^1.2
- symfony/framework-bundle: ^4.4 || ^5.0 || ^6.0
- symfony/phpunit-bridge: ^5.0 | ^6.0
- twig/twig: ^2.10|^3.0
This package is auto-updated.
Last update: 2024-10-19 21:05:34 UTC
README
If you use Disqus on your website for comments the comments are loaded dynamically via JavaScript, which could negatively impact SEO.
This bundle will fetch the comments using Disqus API so that you can include
them on your pageā¦ before replacing the comment div
by the Disqus JavaScript widget.
This way you benefit from both the JavaScript widget and the robot-friendly comments.
Requirements
- Disqus API: public key
Installation
With composer, run:
composer require knplabs/knp-disqus-bundle
If you're not using Symfony Flex, then you will also need to enable
Knp\Bundle\DisqusBundle\KnpDisqusBundle
in your bundles.php
file.
Next, create a config/packages/knp_disqus.yaml
file:
# config/packages/knp_disqus.yaml knp_disqus: api_key: '%env(DISQUS_API_KEY)%'
And finally, configure the DISQUS_API_KEY
in your .env
or .env.local
file:
# .env
DISQUS_API_KEY=ABC123
Usage:
In your Twig template:
{{ knp_disqus_render('your_disqus_shortname', {'identifier': '/december-2010/the-best-day-of-my-life/', 'limit': 10}) }}
You can also show comments for specific language:
{{ knp_disqus_render('your_disqus_shortname', {'identifier': '/december-2010/the-best-day-of-my-life/', 'language': 'de_formal'}) }}
Or in Controller:
use Knp\Bundle\DisqusBundle\Client\DisqusClientInterface; public function somePage(DisqusClientInterface $disqusClient) { // ... $comments = $disqusClient->fetch('your_disqus_shortname', [ 'identifier' => '/december-2010/the-best-day-of-my-life/', 'limit' => 10, // Default limit is set to max. value for Disqus (100 entries) // 'language' => 'de_formal', // You can fetch comments only for specific language ]); return $this->render('articles/somePage.html.twig', [ 'comments' => $comments, ]); }
Adding a Callback for New Comments
If you want a JavaScript function to be called when a new comment is added
(e.g. to trigger some Analytics), first, create a global JavaScript function
somewhere (i.e. one that is attached to the windows
object):
window.onNewComment = function(comment) { console.log(comment); }
Next, pass the function name when rendering:
{{ knp_disqus_render('your_disqus_shortname', { 'identifier': '/december-2010/the-best-day-of-my-life/', 'limit': 10, 'newCommentCallbackFunctionName': 'onNewComment' }) }}
SSO authentication (optional)
If you want to manage authentication through Disqus SSO mechanism, you have to add the application secret key in the configuration and pass user information (id, username, email) which will compose the HMAC payload from it, as well as specific login/logout service information to the helper. Make sure to setup your Disqus forum to use SSO and allow for local domains (for development purposes).
To use SSO auth, pass sso.user
information in the parameters to tell Disqus which user is logged in. Pass a user with an empty id
to force Disqus to logout user, respectively to tell Disqus no user is logged in through SSO. Add information regarding your SSO Authentication service (login/logout urls, icon, etc.) in the sso.service
parameter. See Disqus SSO documentation for more information.
{{ knp_disqus_render( 'dolor-sid', { 'identifier': '/december-2010/the-best-day-of-my-life/', 'limit': 100, 'sso': { 'user': { 'id' : 'test', 'username' : 'John Doe', 'email': 'john.doe@example.com', }, 'service': { 'name': 'MyAuthServiceProvider', 'icon': 'http://example.com/favicon.png', 'button': 'http://example.com/images/samplenews.gif', 'url': 'http://example.com/login/', 'logout': 'http://example.com/logout/', 'width': '400', 'height': '400' } } }, 'KnpDisqusBundle::list.html.twig' ) }}
Configuration
# config/packages/knp_disqus.yaml knp_disqus: api_key: 'your-disqus-api-key' secret_key: 'disqus-api-key' # optional, for SSO auth only
Enjoy!