ContentGuard is a robust PHP content sanitization library specifically designed for the Indonesian web ecosystem. It helps developers filter out online gambling spam (judi online), profanity, and hate speech with advanced detection capabilities.
Unlike simple string replacement tools, ContentGuard uses an intelligent Regex Engine to detect "Leet Speak" (visual masking) commonly used by spammers (e.g., detecting s10t g4c0r as slot gacor).
- ✅ Smart Detection: Catch masked words like
g4c0r,s.l.o.t,judi, etc. - ✅ Pre-built Dictionary: Comes with a comprehensive database of Indonesian gambling terms and profanity.
- ✅ Laravel Ready: Includes Service Provider and Facade for seamless integration.
- ✅ Customizable: Add your own blocklist and configure strictness.
- ✅ Zero Dependencies: Lightweight and fast.
You can install the package via composer:
composer require heyitsmi/content-guardIf you are using Laravel, you can publish the configuration file to customize the behavior (e.g., changing the mask character or adding custom keywords).
Run the following command:
php artisan vendor:publish --tag="content-guard-config"This will create a config/content-guard.php file in your application.
You can use the ContentGuard facade anywhere in your controllers, jobs, or blade directives.
use Heyitsmi\ContentGuard\Facades\ContentGuard;
// 1. Check if text contains bad words (returns boolean)
$isSpam = ContentGuard::hasBadWords("Ayo main s10t g4c0r hari ini!");
if ($isSpam) {
return back()->withErrors(['message' => 'Your comment contains restricted content.']);
}
// 2. Sanitize text (returns clean string)
$cleanText = ContentGuard::sanitize("Jangan main judi online!");
// Output: "Jangan main **** ******!"If you are not using Laravel, you can instantiate the class directly.
use Heyitsmi\ContentGuard\ContentGuard;
$guard = new ContentGuard();
$input = "Situs g.a.c.o.r terpercaya";
if ($guard->hasBadWords($input)) {
echo "Spam detected!";
}
echo $guard->sanitize($input);3. Client-side Masking (Blur or Hidden)
ContentGuard can wrap detected words in HTML tags, allowing you to use CSS and JavaScript for a premium "click-to-reveal" experience.
Publish the assets (CSS and JS):
php artisan vendor:publish --tag="content-guard-assets"In your layout file (e.g., app.blade.php), inclusion the assets using the blade directive:
<head>
...
@contentGuardAssets
</head>Use the wrap() method instead of sanitize() to get HTML-tagged content:
$text = "Bocoran slot gacor hari ini";
// Default is 'blur'
echo ContentGuard::wrap($text);
// Or use 'mask' for a solid black box
echo ContentGuard::wrap($text, 'mask');The wrap() method will generate:
<span class="cg-word cg-blur" data-cg-word="slot">slot</span>
Users can click on the blurred/masked word to reveal the original content.
ContentGuard converts standard keywords into flexible Regex patterns based on a Substitution Map.
-
Input:
slot -
Regex Generated:
/\b(s|5|\$|z)[\W_]*(l|1|!|\|)[\W_]*(o|0|@|ø)[\W_]*(t|7|\+)\b/i -
Matches:
slot,s1ot,s.l.o.t,s-l-o-t,sl0t, etc.
To run the unit tests included in this package:
composer testContributions are welcome! If you find new slang words or spam patterns popular in Indonesia, please submit a Pull Request to update the src/Dictionary files.
The MIT License (MIT). Please see License File for more information.