diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..70778bf --- /dev/null +++ b/.editorconfig @@ -0,0 +1,24 @@ +# For more information about the properties used in +# this file, please see the EditorConfig documentation: +# http://editorconfig.org/ + +[*] +charset = utf-8 +end_of_line = lf +indent_size = 4 +indent_style = tab +insert_final_newline = true +trim_trailing_whitespace = true + +[*.md] +trim_trailing_whitespace = false + +[*.yml] +indent_size = 2 +indent_style = space + +[{.travis.yml,package.json}] +# The indent size used in the `package.json` file cannot be changed +# https://github.com/npm/npm/pull/3180#issuecomment-16336516 +indent_size = 2 +indent_style = space diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..b857c37 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,3 @@ +/tests export-ignore +/.gitattributes export-ignore +/.travis.yml export-ignore diff --git a/changelog.md b/changelog.md new file mode 100644 index 0000000..a98f2b9 --- /dev/null +++ b/changelog.md @@ -0,0 +1,9 @@ +# Changelog + +All notable changes to this project will be documented in this file. + +This project adheres to [Semantic Versioning](http://semver.org/). + +## [2.0.0] + +Changelog added. diff --git a/code-of-conduct.md b/code-of-conduct.md new file mode 100644 index 0000000..12684e3 --- /dev/null +++ b/code-of-conduct.md @@ -0,0 +1,3 @@ +# Code of Conduct + +https://docs.silverstripe.org/en/3.1/contributing/code_of_conduct/ diff --git a/contributing.md b/contributing.md new file mode 100644 index 0000000..32334e2 --- /dev/null +++ b/contributing.md @@ -0,0 +1,3 @@ +# Contributing + +Contributions are welcome! Create an issue, explaining a bug or proposal. Submit pull requests if you feel brave. Speak to me on [Twitter](https://twitter.com/assertchris). diff --git a/README.md b/docs/en/index.md similarity index 81% rename from README.md rename to docs/en/index.md index 31f4735..73aa3d6 100644 --- a/README.md +++ b/docs/en/index.md @@ -5,29 +5,24 @@ [![Version](http://img.shields.io/packagist/v/silverstripe/contentreview.svg?style=flat-square)](https://packagist.org/packages/silverstripe/silverstripe-contentreview) [![License](http://img.shields.io/packagist/l/silverstripe/contentreview.svg?style=flat-square)](LICENSE.md) -This module helps keep your website content accurate and up-to-date, which keeps your users happy. +This module helps keep your website content accurate and up-to-date, which keeps your users happy. -It does so by sending reviewers reminder emails to go in and check the content. For a reviewer this +It does so by sending reviewers reminder emails to go in and check the content. For a reviewer this often includes checking links, grammar, factual information and look and feel. -There are two types of roles with this module. +There are two types of roles with this module. * Website owner; (typically assigned to the Administrator group) ensures that a website is accurate and up-to-date, by delegating responsibility to content reviewers. * Content reviewer; responsible for keeping a website or part of a website accurate and up-to-date. ## Features - * Content reviewer will receive an email notification when a page is due for review. + * Content reviewer will receive an email notification when a page is due for review. * Content reviewer can mark a page as 'reviewed', and provide review notes. * Website owner can assign content reviewers to a page and set when the content should be reviewed. * Website owner can see a report of pages and their reviewed status. * Content reviewers can be assigned to a page, a page and all sub-pages, or globally. - * The content review schedule can be automatic, e.g. every month, and/or a specific date. - -## Wishlist features: - - * Overdue review reminder emails. - * Customisable reminder emails. + * The content review schedule can be automatic, e.g. every month, and/or a specific date. ## Requirements @@ -35,14 +30,16 @@ There are two types of roles with this module. ## Composer installation - composer require silverstripe/contentreview +```sh +$ composer require silverstripe/contentreview +``` ## Manual installation Download or clone the source code into the SilverStripe root folder. Rename the module folder to `contentreview`. -Run dev/build either via the webserver by opening the url `http:///dev/build` or +Run dev/build either via the webserver by opening the url `http:///dev/build` or by running the dev/build via a CLI. ## Configuration @@ -54,8 +51,8 @@ In order for the contentreview module to send emails, you need to *either*: ## Usage -To set up content review schedules you need to log in as a user with the 'Set content owners and review dates' permission. This can either -be an administrator who has all permissions, or by giving a group the specific permission. +To set up content review schedules you need to log in as a user with the 'Set content owners and review dates' permission. This can either +be an administrator who has all permissions, or by giving a group the specific permission. ![](docs/en/images/content-review-permission.png) @@ -63,19 +60,25 @@ To set a content review schedule for a page go to `Settings > Content Review`. ![](docs/en/images/content-review-settings.png) -CMS users without the permission to change the content review schedule can still see the settings +CMS users without the permission to change the content review schedule can still see the settings and previous reviews in the same view, but cannot change anything. ![](docs/en/images/content-review-settings-ro.png) ## Testing -cd to the site root, and run - php vendor/bin/behat +cd to the site root, and run: -or to test this module when used on a website - php vendor/bin/behat contentreview/tests +```sh +$ php vendor/bin/behat +``` + +or to test this module when used on a website: + +```sh +$ php vendor/bin/behat contentreview/tests +``` ## Migration - * If you are upgrading from an older version, you may need to run the ContentReviewOwnerMigrationTask +If you are upgrading from an older version, you may need to run the `ContentReviewOwnerMigrationTask` diff --git a/LICENSE b/license.md similarity index 100% rename from LICENSE rename to license.md diff --git a/readme.md b/readme.md new file mode 100644 index 0000000..9cf23dd --- /dev/null +++ b/readme.md @@ -0,0 +1,55 @@ +# Content Review module + +[![Build Status](https://travis-ci.org/silverstripe-labs/silverstripe-contentreview.png?branch=feature_improvements)](https://travis-ci.org/silverstripe-labs/silverstripe-contentreview) +[![Scrutinizer Quality Score](https://scrutinizer-ci.com/g/silverstripe-labs/silverstripe-contentreview/badges/quality-score.png?s=e68f2c583f03c7eab0326781f6219f0ed58c9ad8)](https://scrutinizer-ci.com/g/silverstripe-labs/silverstripe-contentreview/) +[![Code Coverage](https://scrutinizer-ci.com/g/silverstripe-labs/silverstripe-contentreview/badges/coverage.png?s=42151d66ef5121363face01c03c94dc479baa408)](https://scrutinizer-ci.com/g/silverstripe-labs/silverstripe-contentreview/) + +This module helps keep your website content accurate and up-to-date, which keeps your users happy. + +It does so by sending reviewers reminder emails to go in and check the content. For a reviewer this +often includes checking links, grammar, factual information and look and feel. + +There are two types of roles with this module. + + * Website owner; (typically assigned to the Administrator group) ensures that a website is accurate and up-to-date, by delegating responsibility to content reviewers. + * Content reviewer; responsible for keeping a website or part of a website accurate and up-to-date. + +## Requirements + + * SilverStripe ^3.1 + +## Features + + * Content reviewer will receive an email notification when a page is due for review. + * Content reviewer can mark a page as 'reviewed', and provide review notes. + * Website owner can assign content reviewers to a page and set when the content should be reviewed. + * Website owner can see a report of pages and their reviewed status. + * Content reviewers can be assigned to a page, a page and all sub-pages, or globally. + * The content review schedule can be automatic, e.g. every month, and/or a specific date. + +## Wishlist features + + * Overdue review reminder emails. + * Customisable reminder emails. + +## Composer installation + +```sh +$ composer require silverstripe/contentreview +``` + +You'll also need to run `dev/build`. + +## Documentation + +See the [docs/en](docs/en/introduction.md) folder. + +## Versioning + +This library follows [Semver](http://semver.org). According to Semver, you will be able to upgrade to any minor or patch version of this library without any breaking changes to the public API. Semver also requires that we clearly define the public API for this library. + +All methods, with `public` visibility, are part of the public API. All other methods are not part of the public API. Where possible, we'll try to keep `protected` methods backwards-compatible in minor/patch versions, but if you're overriding methods then please test your work before upgrading. + +## Reporting Issues + +Please [create an issue](https://github.com/silverstripe/silverstripe-contentreview/issues) for any bugs you've found, or features you're missing.