Skip to content

Commit

Permalink
Prepare 1.0.0 release
Browse files Browse the repository at this point in the history
  • Loading branch information
curry684 committed May 4, 2023
1 parent f4a2a02 commit 072ef4e
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 9 deletions.
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Changelog
All notable changes to `omines/akismet` will be documented in this file.
This project adheres to [Semantic Versioning](http://semver.org/).

## 1.0.0 - 2023-05-04

Stable release.

[Unreleased]: https://github.com/omines/akismet/compare/1.0.0...master
14 changes: 5 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
[![License](https://poser.pugx.org/omines/akismet/license)](https://packagist.org/packages/omines/akismet)

This library provides a straightforward object oriented and pluggable implementation of the well known online Akismet
spam detection service.
spam detection service. All known features and calls are implemented.

## Documentation

Expand All @@ -22,7 +22,7 @@ Easiest is to install the [Symfony HTTP Client component](https://symfony.com/do
composer require symfony/http-client
```
When using the Symfony framework this will provide a configurable service you can inject where needed, otherwise you
can instantiate a client using:
can instantiate a stock client using:
```php
$httpClient = HttpClient::create();
```
Expand Down Expand Up @@ -93,7 +93,7 @@ Execution will block when you call any informational methods on the response, in

### Submitting confirmed ham and spam

As mentioned above, when implementing moderation you can safely serialize the `AkismetMessage` instance submitted
As mentioned before, when implementing moderation you can safely serialize the `AkismetMessage` instance submitted
for checking. After human review you can then help improve Akismet's services by submitting the message as ham or spam:
```php
$response = $this->akismet->submitHam($message);
Expand All @@ -118,12 +118,6 @@ foreach ($response->getMonths() as $month => $activities) {
```
For the parameters and response formats of the activity call refer to [the Akismet documentation](https://akismet.com/key-sites-activity/).

## To Do

This library is currently internally being tested for production use, changes may be necessary, hence the library is
currently in major version 0. It is to be considered stable and safe though, and we will stabilize the major version
once we believe the library API to be sufficiently stable.

## Contributing

Contributions are **welcome** and will be credited.
Expand All @@ -133,6 +127,8 @@ Follow [good standards](http://www.phptherightway.com/), keep the [PHPStan level
and keep the test coverage at 100%.

Before committing, run `bin/prepare-commit` to automatically follow coding standards, run PHPStan and run all tests.
To run the live tests create a `.env.local` defining `AKISMET_KEY`. As they run in test mode they will not interfere
with your quota or get you banned.

## Legal

Expand Down

0 comments on commit 072ef4e

Please sign in to comment.