{"id":28913875,"url":"https://github.com/fabiomux/jekyll-disqus-plugin","last_synced_at":"2026-05-19T07:02:40.862Z","repository":{"id":81994118,"uuid":"604544596","full_name":"fabiomux/jekyll-disqus-plugin","owner":"fabiomux","description":"Jekyll plugin that provides all the required tags to render the Disqus comment section and the counter.","archived":false,"fork":false,"pushed_at":"2023-12-27T17:57:09.000Z","size":61,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-15T13:12:07.510Z","etag":null,"topics":["disqus","jekyll","jekyll-plugin","ruby","ruby-gem"],"latest_commit_sha":null,"homepage":"https://freeaptitude.altervista.org/projects/jekyll-disqus.html","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabiomux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["fabiomux"],"ko_fi":"freeaptitude","custom":["https://paypal.me/fabiomux","https://www.buymeacoffee.com/DCkNYFg"]}},"created_at":"2023-02-21T09:33:59.000Z","updated_at":"2024-04-29T08:27:54.000Z","dependencies_parsed_at":"2023-12-26T11:31:38.548Z","dependency_job_id":"39f4008c-c283-4558-8e9d-110db4ab12c4","html_url":"https://github.com/fabiomux/jekyll-disqus-plugin","commit_stats":{"total_commits":23,"total_committers":1,"mean_commits":23.0,"dds":0.0,"last_synced_commit":"3ffb53c4caf7cf19775e8b89391b854b39349026"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/fabiomux/jekyll-disqus-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiomux%2Fjekyll-disqus-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiomux%2Fjekyll-disqus-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiomux%2Fjekyll-disqus-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiomux%2Fjekyll-disqus-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabiomux","download_url":"https://codeload.github.com/fabiomux/jekyll-disqus-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabiomux%2Fjekyll-disqus-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33205431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-18T09:27:30.708Z","status":"online","status_checked_at":"2026-05-19T02:00:06.763Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["disqus","jekyll","jekyll-plugin","ruby","ruby-gem"],"created_at":"2025-06-21T21:10:59.429Z","updated_at":"2026-05-19T07:02:40.806Z","avatar_url":"https://github.com/fabiomux.png","language":"Ruby","funding_links":["https://github.com/sponsors/fabiomux","https://ko-fi.com/freeaptitude","https://paypal.me/fabiomux","https://www.buymeacoffee.com/DCkNYFg"],"categories":[],"sub_categories":[],"readme":"# Jekyll-Disqus\n\nThis is a Jekyll plugin that provides the Liquid tags to render the Disqus Javascript codes inside the\ntheme template.\n\nIt also associates a different *ID* to every *post* using its publishing date and ensures the uniqueness\nof that ID among all the posts.\n\nAlthough the *ID* can be automatically generated is still possible to declare a custom *ID*, which is \nmandatory for those pages that don't contain a publishing date but recall one of the Disqus tags in \ntheir layouts.\n\n[![Ruby](https://github.com/fabiomux/jekyll-disqus-plugin/actions/workflows/main.yml/badge.svg)][wf_main]\n[![Gem Version](https://badge.fury.io/rb/jekyll-disqus-plugin.svg)][gem_version]\n\n## Installation\n\nCan install the gem either manually or using *Bundler*.\n\n### Using Bundler\n\nInstall the gem and add to the application's Gemfile by executing:\n\n    $ bundle add jekyll-disqus-plugin --group jekyll_plugins\n\n### Manually\n\nIf bundler is not being used to manage dependencies, install the gem by executing:\n\n    $ gem install jekyll-disqus-plugin\n\nThen, add the following code within the Gemfile of your Jekyll project:\n\n    ```ruby\n    group :jekyll_plugins do\n      ...\n      gem 'jekyll-disqus-plugin'\n    end\n    ```\n\n## Configuration\n\nInside the `_config.yml` file can set up the following fields:\n```yaml\njekyll-disqus:\n  shortname:\n  id_prefix: \n  post_selector: 'include.post'\n  ui:\n    layouts:\n    - 'post'\n  counter:\n    layouts:\n    - 'all'\n```\n\n*shortname*\n: It is the same *Shortname* provided by Disqus for each site added.\n\n*id_prefix*\n: It is a code that will be prepended to any *Disqus Id*, just to add another level of customization.\n\n*post_selector*\n: This is how the script will read the post data inside a paginator layout.\n\n*ui.layouts*/*counter.layouts*\n: A list of layouts where the two couple of tags will be printed.\n\nTo disable the tags for specific pages or posts, the *no_disqus* field can be set up to true on the front\nmatter of the specific post or page itself.\n\nBy default, this addon associates a unique *ID* to each *post* using the related publishing date, but\nwhere needed, a *disqus_id* field can be declared in the front matter of the page. \n```yaml\n---\ntitle: ...\ndescription: ...\nauthor: ...\n...\ndisqus_id: 'CUSTOM_DISQUS_ID'\n...\n```\n\nThere is a deep relationship between the *disqus_id* and the related post, so be sure that:\n- The custom disqus_id will remain unique, otherwise an error will be raised at the building time;\n- the custom disqus_id won't change after the page has been published, otherwise all the comments\n    associated with the post will be lost;\n- the publishing date, where the *ID* is not customized, doesn't change, or all the comments associated\n    with the post will be lost.\n\n## Usage\n\nBelow are the provided tags:\n\n|            Tag              |                      Description                    | Template |\n|:---------------------------:|-----------------------------------------------------|:--------:|\n| {% disqus_counter %}        |The count of comments for a certain post             |   Post   |\n| {% disqus_script_counter %} |The required Javascript that renders the counter     |  Default |\n| {% disqus_ui %}             |The comment box                                      |   Post   |\n| {% disqus_script_ui %}      |The required Javascript that renders the comment box |  Default |\n\nThe *script* tags must be included once for page and, providing a Javascript code, their position should\nbe in the bottom part of the main layout, just before the end of the *body* HTML tag.\n\nThe *disqus_ui* renders the comment box and should be put in the post or page layout, depending\nwhere you want to show it, usually after the *content* has been printed.\n\nThe *disqus_counter* shows the number of comments for a  post (or page), and it is \nbound to the specific content through the *disqus_id* aforementioned.\nUsually, it is displayed among the content *data*, just after the title, and it works for the full\nrendered post as well as the paginated content.\n\nIn the last case, the plugin will detect the post included in the pagination template using a selector.\nBy default, it is `include.post`, but can be changed in the configuration section of the `_config.yml`\nfile.\n\n## More Help\n\nMore info is available at:\n- the [project page on the Freeaptitude blog][project_page];\n- the [Jekyll-Disqus Github wiki][jekyll_disqus_wiki].\n\n[project_page]: https://freeaptitude.altervista.org/projects/jekyll-disqus.html \"Project page on the Freeaptitude blog\"\n[jekyll_disqus_wiki]: https://github.com/fabiomux/jekyll-disqus-plugin/wiki \"Jekyll-Disqus wiki page on GitHub\"\n[wf_main]: https://github.com/fabiomux/jekyll-disqus-plugin/actions/workflows/main.yml\n[gem_version]: https://badge.fury.io/rb/jekyll-disqus-plugin\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabiomux%2Fjekyll-disqus-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabiomux%2Fjekyll-disqus-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabiomux%2Fjekyll-disqus-plugin/lists"}