huettig-und-rompf/webhub-proxy

A proxy script to include the Hüttig & Rompf Webhub Snippets on your website in complete privacy

1.2.1 2021-04-16 16:02 UTC

Requires

• laminas/laminas-diactoros: ^2.3
• laminas/laminas-httphandlerrunner: ^1.2
• laminas/laminas-stratigility: ^3.2
• middlewares/proxy: ^1.1

Apache-2.0

• Huettig & Rompf
• LABOR.digital
• Martin Neundorfer

README

This script can be installed on your webserver to proxy all requests to the Huettig and Rompf Webhub trough your own server. What that means is, that there is absolutely no privacy related data (like your users ip address) sent to Huettig and Rompf servers. Therefore, you are safe to use the snippets/calculators without additional "opt-in" feature for GDPR.

Requirements

• PHP >=7.2
• PHP gzip
• Apache Webserver with mod-rewrite enabled
• or nginx with additional configuration

Installation

Install this package using Composer:

composer require huettig-und-rompf/webhub-proxy

After you installed the bundle:

1. Copy the "webhub-proxy" directory somewhere into your website's public docroot.
2. Open the "index.php" in the copied "webhub-proxy" directory in an editor.
3. Adjust the $VENDOR_DIR path (line 25) to match the requirements in your setup.
4. Deploy the script to your production machine

Usage

1. Go to Online Marketing
2. Select one of the available snippets
3. Copy the embed-code into your templates
4. Adjust the first script tag to match your local proxy setup e.g <script type="text/javascript" src="https://webhub.huettig-rompf.de/js/snippet"></script> becomes: <script type="text/javascript" src="https://example.org/webhub-proxy/js/snippet"></script>

Nginx Configuration

If you are running your websites with nginx instead of apache, edit your configuration file to include this location directive:

Option A: Inside a sub-directory

server {
    server_name example.com;
    location /webhub-proxy {
       try_files $uri $uri/ /webhub-proxy/index.php?$query_string;
    }
}

Option B: Using a separarte URL

server {
    server_name webhub-proxy.example.com;
    location / {
       try_files $uri $uri/ /index.php?$query_string;
    }
}