Local Development

If you are a developer looking to integrate Locadapt into your local development workflow or test on non-production domains, follow these steps:

Adding Locadapt to your `localhost` project

To use Locadapt in your local development environment, add these two script tags to the <head> of your HTML file:

<link rel="stylesheet" href="https://cdn.locadapt.com/locadapt.min.css" />
<script
  src="https://cdn.locadapt.com/locadapt.min.js"
  data-project-id="YOUR_PROJECT_ID"
></script>

You can find these scripts ready to copy, along with your project ID, on the Configuration page for your Locadapt project.

To enable Locadapt on localhost or other non-production domains:

Navigate to the Configuration page in your Locadapt dashboard.
Find the “Local Development” section with a JavaScript snippet containing your secret key.
Copy and run this snippet in your browser’s console while on your local development site:

const d = new Date();
d.setTime(d.getTime() + 365.2422 * 10 * 24 * 60 * 60 * 1000);
const expires = "expires=" + d.toUTCString();
const cookieName = "locadapt-secret-key";
const cookieValue = "YOUR_SECRET_KEY";
const cookieString = 
    `${cookieName}=${cookieValue};${expires};path=/;SameSite=Strict;`;

if (window.location.protocol === "https:") {
    document.cookie = cookieString + "Secure;";
} else {
    document.cookie = cookieString;
}

console.log(`Secret key cookie set: ${cookieName}`);

Replace YOUR_SECRET_KEY with your actual secret key or copy the entire snippet directly from your dashboard.

This sets a cookie allowing Locadapt to function on test domains.

Deploying to production

When deploying Locadapt to your own production site:

Navigate to the Configuration page in your Locadapt dashboard.
Go to the “Options” tab.
Configure the allowed domains for your project (similar to CORS settings).
You won’t need to use the secret key for your own production domains.

Testing on foreign production sites

Best practices

Use version control

Track changes and collaborate by keeping your Locadapt configuration in version control.

Secure your key

Never commit or share your local development key. Use environment variables or secure vaults for sensitive information.

Stay updated

Regularly check for updates to Locadapt’s scripts and documentation for the latest features and best practices.

Leverage our support

Reach out to our dedicated support team for any questions or assistance during your development process.

For more detailed information on integrating Locadapt into your development workflow, reach out to the team or check out the API Reference page.

Get Started

Details

Plugins

Local Development

Adding Locadapt to your `localhost` project

Deploying to production

Testing on foreign production sites

Best practices

Use version control

Secure your key

Stay updated

Leverage our support

Get Started

Details

Plugins

​Adding Locadapt to your localhost project

​Deploying to production

​Testing on foreign production sites

​Best practices

Use version control

Secure your key

Stay updated

Leverage our support

Adding Locadapt to your `localhost` project

Deploying to production

Testing on foreign production sites

Best practices