Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blomstra/flarum-ext-spam-prevention
https://github.com/blomstra/flarum-ext-spam-prevention
Last synced: 14 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/blomstra/flarum-ext-spam-prevention
- Owner: blomstra
- Fork: true (luceos/flarum-simple-spam-tools)
- Created: 2022-09-01T12:43:04.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-08-03T16:28:23.000Z (3 months ago)
- Last Synced: 2024-10-15T09:11:36.893Z (30 days ago)
- Language: PHP
- Size: 49.8 KB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Spam prevention is an extension based on our spam fighting experience on the official Flarum community Discuss. After installation it does a great job at preventing any form of unwanted spam. Give it a spin if spam is an annoyance on your community!
### Requirements
- flarum/approval - this is required
- flarum/flags - this is recommended
- fof/spamblock - optional, when enabled immediately deletes users that open discussions with spam subjects
### Installation
```
composer require blomstra/spam-prevention
```
Now enable this extension from your admin area and it will already do its job. No further configuration needed.
That's it. Read below what this package does and how to customize its behavior.
### Spam prevent logic
How does it try to identify spam?
- it scans for phone numbers
- it scans for email addresses
- it scans for links that aren't in the allow list
- it identifies the language used against the language packs installed
- it ignores elevated users (mods and admins)
Where does it scan for spam?
- it scans (first) posts
- it scans user bio's
How does it take action?
- it flags posts with flarum/flags enabled
- it marks posts as not approved with flarum/approval enabled
- it overwrites user bio's if it identifies spam
- it marks users as spammer if a discussion subject contains spam with fof/spamblock
### Customization
```php
allowLinksFromDomain('luceos.com')
// or just a full domain with protocol, only the host name is used
->allowLinksFromDomain('http://flarum.org')
// even a link works, only the domain will be used
->allowLinksFromDomain('discuss.flarum.org/d/26095')
// Alternatively, use an array of domains
->allowLinksFromDomains([
'luceos.com',
'flarum.org',
'discuss.flarum.org'
])
// Use custom (expert) logic.
// Return true to ignore further checking this link for validity.
->allowLink(function (Uri $uri, User $actor = null) {
if ($uri->getHost() === '127.0.0.1') return true;
})
// How long after sign up all posts are scrutinized for bad content
->checkForUserUpToHoursSinceSignUp(5)
// How many of the first posts of a user to scrutinize for bad content
->checkForUserUpToPostContribution(5)
// Specify the user Id of the moderator raising flags for some actions, otherwise the first admin is used
->moderateAsUser(2)
// Disable specific spam prevention components
->disable(\Blomstra\Spam\Filters\UserBio::class),
];
```
### FAQ
__Why is there no admin settings page?__
Building a ux for an extension takes a lot of time, especially when the code isn't mature enough. Changes to the inner workings might affect a settings page countless times. We will build a settings page once we're satisfied about the features contained in this tool.
---
- Blomstra provides managed Flarum hosting and development.
- https://blomstra.net
- https://blomstra.community/t/ext-spam-prevention
- https://github.com/blomstra/flarum-ext-spam-prevention