npm package: @mitkoz/jquery-comments
Description: jQuery plugin for implementing an out-of-the-box commenting solution to any web application with an existing backend
Author: Joona Tykkylainen
Latest version: 1.3.1

# jquery-comments
## I don't own any of this. The package has been created with the code from the GitHub repository, since the author hasn't updated his npm package from a long time (https://www.npmjs.com/package/jquery-comments). The current package was created by commit 168ebf66ca33f16aab672dd5072503bd4333737a (Oct 22, 2019). All credits go to the author of the code :)

jquery-comments is a jQuery plugin for implementing an out-of-the-box commenting solution to any web application with an existing backend. It provides all the UI functionalities and ties them to callbacks that let you easily define what you want to do with the data. The library is highly customizable and very easy to integrate thanks to a wide variety of settings.

![Screenshot of jquery-comments](screenshot.png?raw=true "Screenshot of jquery-comments")

Features
--------
- Commenting
- Replying (nested comments)
- Editing comments
- Deleting comments
- Upvoting comments
- Uploading attachments
- Hashtags
- Pinging users
- Enabling/disabling functionalities
- Localization
- Time formatting
- Field mappings
- Callbacks
- Fully responsive and mobile compatible
- Miscellaneous settings

Demo
----
http://viima.github.io/jquery-comments/demo/

Quick start
-----------
**1) Add the following to your HTML file**
```html
<link rel="stylesheet" type="text/css" href="css/jquery-comments.css">
<link rel="stylesheet" type="text/css" href="https://maxcdn.bootstrapcdn.com/font-awesome/4.5.0/css/font-awesome.min.css">

<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script>
<script type="text/javascript" src="js/jquery-comments.js"></script>
```

**2) Initialize the library**
```javascript
$('#comments-container').comments({
    getComments: function(success, error) {
        var commentsArray = [{
            id: 1,
            created: '2015-10-01',
            content: 'Lorem ipsum dolort sit amet',
            fullname: 'Simon Powell',
            upvote_count: 2,
            user_has_upvoted: false
        }];
        success(commentsArray);
    }
});
```
If you are not using Font Awesome for icons, you should replace the icons with custom images by overriding following options when initializing the library:
```javascript
spinnerIconURL: '',
noCommentsIconURL: '',
upvoteIconURL: '',		// Only if upvoting is enabled
replyIconURL: '',		// Only if replying is enabled
uploadIconURL: '',		// Only if attachments are enabled
attachmentIconURL: '',	// Only if attachments are enabled
fileIconURL: '',		// Only if attachments are enabled
```

Dependencies
------------
- jQuery >= 1.9.0
- Font Awesome (optional)
- jquery-textcomplete (optional)

Documentation
-------------
http://viima.github.io/jquery-comments

Maintainers
-----------
- [Joona Tykkyläinen](https://www.linkedin.com/in/joonatykkylainen), Viima Solutions Oy

Browser support
---------------
IE9+ and all modern browsers

Copyright and license
---------------------
Code and documentation copyright 2017 [Viima Solutions Oy](https://www.viima.com/). Code released under [the MIT license](https://github.com/Viima/jquery-comments/blob/master/LICENSE).