Palantics Tracker Helper

A server-side solution that enhances tracking capabilities by handling third-party requests directly from your server, effectively bypassing anti-tracking measures.

While direct integration between the frontend script and tracker server is possible, this helper provides a more robust solution recommended for production environments.

WordPress Plugin Installation

The WordPress plugin includes the helper functionality integrated into the PHP backend for seamless operation.

1. Copy the contents of the WordPress folder to your WordPress plugins directory

OR zip it and upload

cd wordpress
zip -r palantics-tracking-plugin.zip palantics-tracking-plugin/

2. Configure the tracker endpoint with your domain in the plugin settings
3. Track click events by either:
   • Wrapping elements in the Analysis block
   • Using the onclick attribute on elements:

   <div onclick="tE('eventName')">Your content</div>
   

WordPress Plugin Features

• Automatic configuration of most tracking requirements
• Click event tracking for selected elements
• Class-based automatic tracking (configurable in settings)
• Built-in pageload tracking

Note: If you're using WordPress, your installation is now complete. The remaining sections are only necessary for non-WordPress environments.

General Helper Installation

For non-WordPress environments, use our general helper service.

Step 1: Server Setup

# Clone the repository
git clone https://gitea.karlbreuer.com/karl/palanticshelper.git
cd palanticshelper

# Configure environment
cp example.env .env

Edit your .env file to set the correct tracking server endpoint, then start the service:

docker-compose up -d

Step 2: Reverse Proxy Configuration

Configure your reverse proxy to forward tracking requests to the Palantics Helper.

NGINX Configuration:

location /spur {
    proxy_pass http://127.0.0.1:8101;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Traefik Configuration:

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.palantics.rule=Host(`yourdomain.com`) && PathPrefix(`/spur`)"
  - "traefik.http.routers.palantics.entrypoints=web,websecure"
  - "traefik.http.routers.palantics.tls=true"
  - "traefik.http.services.palantics.loadbalancer.server.port=8101"

Step 3: Frontend Integration

Add the tracking script from the script folder to your site's header.

Step 4: Implement Event Tracking

Track user interactions by adding the onclick attribute to elements:

<div onclick="tE('eventName')">Your content</div>

The tracker automatically collects pageload data without additional configuration.

Additional Plugins

Support for other platforms is under development. Check back for updates.