{"id":28746176,"url":"https://github.com/ether/ep_comments_page","last_synced_at":"2025-12-18T01:00:15.998Z","repository":{"id":10378672,"uuid":"12524052","full_name":"ether/ep_comments_page","owner":"ether","description":"Comments in Etherpad - No Longer Highly Experimental, now highly awesome!","archived":false,"fork":false,"pushed_at":"2025-11-13T12:06:10.000Z","size":1392,"stargazers_count":46,"open_issues_count":32,"forks_count":51,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-11-13T14:12:22.465Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ether.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2013-09-01T17:23:20.000Z","updated_at":"2025-11-13T12:06:14.000Z","dependencies_parsed_at":"2023-10-02T05:15:26.774Z","dependency_job_id":"3c1f932b-9b22-45c1-8218-45611c4e0723","html_url":"https://github.com/ether/ep_comments_page","commit_stats":null,"previous_names":["ether/ep_comments","johnmclear/ep_comments"],"tags_count":126,"template":false,"template_full_name":null,"purl":"pkg:github/ether/ep_comments_page","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fep_comments_page","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fep_comments_page/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fep_comments_page/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fep_comments_page/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ether","download_url":"https://codeload.github.com/ether/ep_comments_page/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ether%2Fep_comments_page/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27788707,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-17T02:00:08.291Z","response_time":55,"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":[],"created_at":"2025-06-16T14:30:38.206Z","updated_at":"2025-12-18T01:00:15.921Z","avatar_url":"https://github.com/ether.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Publish Status](https://github.com/ether/ep_comments_page/workflows/Node.js%20Package/badge.svg) ![Backend Tests Status](https://github.com/ether/ep_comments_page/workflows/Backend%20tests/badge.svg)\n\n# Comments and annotations for Etherpad\n\n![Screen shot](https://user-images.githubusercontent.com/220864/98013526-617ff900-1df2-11eb-88b6-cf259372f6ca.PNG)\n\n## Installing this plugin with npm.\n```\nnpm install ep_comments_page\n```\n\n## Extra settings\nThis plugin has some extra features that can be enabled by changing values on `settings.json` of your Etherpad instance.\n\n### Alternative comment display\nThere is an alternative way to display comments. Instead of having all comments visible on the right of the page, you can have just an icon on the right margin of the page. Comment details are displayed when user clicks on the comment icon:\n\n![Screen shot](http://i.imgur.com/cEo7PdL.png)\n\nTo use this way of displaying comments, add the following to your `settings.json`:\n```\n// Display comments as icons, not boxes\n\"ep_comments_page\": {\n  \"displayCommentAsIcon\": true\n},\n```\n\n### Highlight selected text when creating a comment\nIt is also possible to mark the text originally selected when user adds a comment:\n![Screen shot](http://i.imgur.com/AhaVgRZ.png)\n\nTo enable this feature, add the following code to your `settings.json`:\n```\n// Highlight selected text when adding comment\n\"ep_comments_page\": {\n  \"highlightSelectedText\": true\n},\n```\n\n**Warning**: there is a side effect when you enable this feature: a revision is created everytime the text is highlighted, resulting on apparently \"empty\" changes when you check your pad on the timeslider. If that is an issue for you, we don't recommend you to use this feature.\n\n### Disable HTML export\nBy default comments are exported to HTML, but if you don't wish to do that then you can disable it by adding the following to your `settings.json`:\n```\n\"ep_comments_page\": {\n  \"exportHtml\": false\n},\n```\n\n## Creating comment via API\nIf you need to add comments to a pad:\n\n* Call this route to create the comments on Etherpad and get the comment ids:\n  ```\n  curl -X POST http://localhost:9001/p/THE_PAD_ID/comments -d \"apikey=YOUR_API_KEY\" -d 'data=[{\"name\":\"AUTHOR\",\"text\":\"COMMENT\"}, {\"name\":\"ANOTHER_AUTHOR\",\"text\":\"ANOTHER_COMMENT\"}]'\n  ```\n\n  The response will be:\n  ```\n  {\"code\":0,\"commentIds\":[\"c-VEtzKolgD5krJOVU\",\"c-B8MEmAT0NJ9usUwc\"]}\n  ```\n\n* Use the returned comment ids to set the pad HTML [via API](http://etherpad.org/doc/v1.5.6/#index_sethtml_padid_html):\n  ```\n  My comment goes \u003cspan class=\"comment c-VEtzKolgD5krJOVU\"\u003ehere\u003cspan\u003e.\n  ```\n\n  Result:\n  ![Screen shot](http://i.imgur.com/KM4lPJx.png)\n\nNOTE: Adding a comment to a pad via API will make the other editors with that pad to be alerted, but this feature is only active if your Etherpad is run in `loadTest` mode. Read [the Etherpad Guide](https://github.com/ether/etherpad-lite/wiki/Load-Testing-Etherpad) for how to enable load testing.\n\n## License\nApache 2\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fether%2Fep_comments_page","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fether%2Fep_comments_page","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fether%2Fep_comments_page/lists"}