Download the PHP package devgeniem/dustpress-comments without Composer
On this page you can find all versions of the php package devgeniem/dustpress-comments. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package dustpress-comments
Comments Helper
DustPress helpers are a handy tool for creating templates with a bit more logic. Comments Helper is a DustPress plugin for enabling commenting in DustPress based themes.
Use Comments Helper with your desired parameters and DustPress will provide an AJAX powered commenting for your posts and pages. This plugin provides base templates for a quick start. Just install and enable the plugin. You can override the templates with your own templates by adding them with the corresponding names in /partials directory inside your theme, for example starting with the container in: wp-content/themes/best-theme-ever/partials/commentscontainer.dust.
To enable full page caching on pages using DustPress Comments the helper parameters must be passed via filter or model functions. You have to provide two functions: one for fetching the comments parameters and another for comment form parameters. The filter slug or the model name will be written into the comments section dataset and into a hidden input field in the comment form. Each AJAX request will include the slug or the model name for the DustPress Comments to be able to retrieve the correct helper parameters. There are examples of both cases at the end of this document.
Functionalities
- threaded comment loading (threaded commenting is enabled via the WordPress discussion settings)
- comment list rendering
- form rendering
- ajaxified pagination (pagination is enabled via the WordPress discussion settings and uses the DustPress Pagination helper)
- ajaxified comment submission
- ajaxified and JS powered replying
- status message displaying and hiding with JS and CSS
- external JS invocation
- support for multiple commenting sections on one page!
- support for full page caching!
Included base templates
- comments-container.dust (the comments section)
- comments.dust (comment list, pagination, form)
- comment.dust (single comment)
Accepted parameters
We will document a full list of parameters in the near future! If you have questions of the helper usage, please contact us at [email protected] or create a new issue.
Example usage
We provide two options for using the helper and passing parameters for its use.
Model functions for helper parameters
Both functions will get the current post id as a parameter.
Then in your dust partial pass this model for your helper as a string.
Filter functions for helper parameters
The other way to pass parameters for the helper is to create two filter functions. The filter slug to be passed for the helper is the third part of the filter string devided with /. Each function must extend the passed $args array and then return it.
Then in your dust partial pass the filter slug for your helper as a string.
Extended functionality
DustPress Comments extends WordPress comment form functionalities with some additional features. Use the following associative keys in your comment form params with the corresponding value types:
- replace_input: array( '{field_name}' => {somehtml} )
- replace a comment form input field by assigning an array key to match the name field of the input
- remove_input: array( '{fieldname}' )
- remove comment form input by assigning array key to match the input name field
External JavaScript function invocation
If you need to hook your own scripts into DustPress Comments, we provide a handy way of adding external listeners for JavaScript actions. This is done via accessing the global Comments object under the window object which holds our global DustPress object.
Each time DustPress Comments is performing an action it will fire your listener function with two parameters. state refers to the state commenting is in and container is the current commenting section as a jQuery object. The section also works a wrapper object for you to fetch all the data that is linked into the commenting at the current state.
Go and build a loader or some other neat functionality!
States
- submit
- reply
- cancelReply
- paginate
- success
- error
