cloakings/cloakings-palladium

Cloakings Palladium Client

1.2.0 2024-06-26 15:57 UTC

Requires

• php: >=8.3
• ext-curl: *
• cloakings/cloakings-common: ^1.1
• gupalo/json: ^1.0
• psr/log: ^3.0
• symfony/http-client: ^7.1

Requires (Dev)

• phpunit/phpunit: ^10.5

MIT

README

Detect if user is bot or real user using palladium.expert

Install

composer require cloakings/cloakings-palladium

Usage

Basic Usage

Register at https://palladium.expert. Create campaign:

• Link to the target page: real.php
• Link for bots: fake.php

Click "download code" for plain PHP or Wordpress and look for:

• clientId
• clientCompany
• clientSecret

$request = \Symfony\Component\HttpFoundation\Request::createFromGlobals();
$cloaker = \Cloakings\CloakingsPalladium\PalladiumCloaker(
    clientId: $clientId,
    clientCompany: $clientCompany,
    clientSecret: $clientSecret,
);
$cloakerResult = $cloaker->handle($request);

Check if result mode is CloakModeEnum::Fake or CloakModeEnum::Real and do something with it.

If you want to render result like the original Palladium library

$baseIncludeDir = __DIR__; // change to your dir with real.php and fake.php
$renderer = \Cloakings\CloakingsPalladium\PalladiumRenderer();
$response = $renderer->render($cloakerResult);

If your filenames differ from real.php and fake.php change params $fakeTargetContains and $realTargetContains in PalladiumCloaker constructor.

Default traffic source is PalladiumTrafficSourceEnum::Adwords but you can change it to Facebook or Tiktok.

Original Logic

Original library is located at doc/original:

• php - plain PHP integration
• wordpress - WordPress integration

License for this repository doesn't cover that code.