Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/divinedominion/vanilla-comments

Vanilla Forum comments for Bludit pages
https://github.com/divinedominion/vanilla-comments

bludit comments vanilla-forums

Last synced: 17 days ago
JSON representation

Vanilla Forum comments for Bludit pages

Host: GitHub
URL: https://github.com/divinedominion/vanilla-comments
Owner: DivineDominion
License: mit
Created: 2019-08-26T09:10:37.000Z (about 5 years ago)
Default Branch: master
Last Pushed: 2024-01-11T09:44:45.000Z (10 months ago)
Last Synced: 2024-01-11T13:43:09.161Z (10 months ago)
Topics: bludit, comments, vanilla-forums
Language: PHP
Size: 7.81 KB
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Vanilla Comments plugin

[![Bludit](https://img.shields.io/badge/Bludit-v3.9.2-0078D4.svg?style=flat-square)](https://www.bludit.com)
[![Vanilla Forums](https://img.shields.io/badge/Vanilla-v2.x/v3.x-0078D4.svg?style=flat-square)][vanilla]
![Version](https://img.shields.io/github/tag/DivineDominion/vanilla-comments.svg?style=flat)
![License](https://img.shields.io/github/license/DivineDominion/vanilla-comments.svg?style=flat)

Use your existing [Vanilla Forum][vanilla] to embed comments on pages in your Bludit flat-file CMS.

[vanilla]: https://vanillaforums.com/

## Features

- Configure the position where the Vanilla comment embed code is displayed.
- Conditionally allow/disallow comments for individual pages. The Bludit system default is "allow".

## Requirements

- Vanilla Forum v2.x and v3.x with the [embed settings enabled](https://docs.vanillaforums.com/help/embedding/)
- Bludit v3.5.0+

## Installation

- Download the the current [`master` as a zip](https://github.com/DivineDominion/BluditVanillaComments/zipball/master)
- Unzip the package
- Upload the resulting `vanilla-comments` folder to your `bl-plugins/` folder
- Visit the Bludit admin page and enable the "Vanilla Comments" plugin through "Settings" > "Plugins"
- Configure the forum settings from the plugins page

### Manual Discussion ID

Discussions are auto-generated by default.

To manually set the `vanillaDiscussionId` field in the comments section, add custom fields to Bludit:

- `customDiscussionID`: that holds the discussion ID (number), which suffices to attach a _new_ post to an existing discussion;
- `customVanillaIdentifier`: that holds the slug of another post to steal discussions from.

```json
"customDiscussionID": {
"type": "string",
"label": "Forum Discussion ID Override",
"placeholder": "(Optional: Existing forum discussion ID)",
"tip": "Leave empty to auto-generate discussions! Attach to a pre-existing discussion. Copy the number in the URL of an existing discussion like 123 in forum.example.com/discussion/123/...."
},
"customVanillaIdentifier": {
"type": "string",
"label": "Forum Identifier Override",
"placeholder": "(Optional: URL of other post)"
}
```

See the docs: https://docs.bludit.com/en/content/custom-fields

## License