ContentQL DocsDisqus
If you're looking for a fast and effective solution to add fully functional commenting capabilities to your theme, Disqus could be the ideal choice for you.
Step 1: Create a Disqus Account
To begin, you'll need to create a Disqus account and set up your website for comments.
Important: Make sure you select a unique shortname during setup, as this will be required later for integration.
Visit the Disqus website and sign up for an account or log in if you already have one.
Navigate to the Admin section and click on Your Sites. Then, select Add a Site to register your website.
Enter a unique shortname for your site when prompted. This will be the identifier used to load Disqus comments on your pages.
Step 2: Login to Your Project's Admin Panel
After setting up your Disqus account, you’ll now integrate Disqus into your project built with ContentQL.
First, log in to the admin panel of your project. You can access it by appending /admin to your project's domain.
In the admin dashboard, navigate to the Pages Collection. Choose the page
where you want to add Disqus comments, such as a blog-details page. If the
page does not exist, create a new one.
Step 3: Add the Disqus Block
Now, let's add the Disqus comment block to your selected page.
Open the page editor and click on the Layout button.
From the list of available blocks, select the Disqus Comment Block.
Go back to your Disqus account and copy the shortname you created earlier. Paste this shortname into the Shortname field of the Disqus Comment Block.
Once you’ve entered the shortname, save your changes and publish the page.
Step 4: Verify the Comments on Your Site
Once you’ve integrated the Disqus block and published the page:
- Go to the page on your live website where you added the comment block.
- Scroll down to verify that the Disqus comments section is loading correctly.
- Users can now start leaving comments, and you can manage them through your Disqus admin dashboard.
If comments are not appearing, ensure your shortname is correctly configured and that the Disqus script is loading without errors in your browser’s console.
Final Thoughts
Integrating Disqus into ContentQL allows you to easily add a commenting system to your pages, enhancing user engagement and interaction. You can reuse the Disqus Comment Block across any page where you want comments, streamlining the integration process.