PHP documentation outdated about km-support HOT 5 CLOSED

@eskfung The link on our support page points to our new PHP library, but still documents the old PHP interface. I'm thinking we could update the main PHP docs page to use our new PHP library, but have a link to an archived version of the docs that shows the old specs. Thoughts?

from km-support.

@percyhanna 👍, gotta get familiar with the new PHP interface. Will try to get this finished by the end of the week.

from km-support.

@DataTables thank you for the feedback! I am reusing the examples included in the kissmetrics-php README, so please let us know if that is not sufficient.

from km-support.

I have two suggestions to improve the documentation shown there if I may:

1. Include instructions on how to include the library files. Its a simple require statement in PHP, but at the moment you need to include the files individually and in a particular order. I've just sent a pull request which makes is a single one line include, but I would still recommend including that in the documentation - require( 'KISSMetrics/KM.php' ); if you accept my pull request.
2. The line >alias('old-anonymous-cookie') appears to be meaningless. The string value given has no particular value - what we need is the anonymous cookie value. I've used the following for that (although I'm not 100% certain that this is the correct way to do it):

            if ( isset( $_COOKIE['km_ai'] ) ) {
                $km->alias( $_COOKIE['km_ai'] );
            }

The server-side libraries are presumably used primarily for triggering events on the sever-side only so hopefully this will make it a little bit easier for people new to KISSMetrics such as myself to get going with it if they are using PHP.

from km-support.

@DataTables thanks for the suggestions, I think those seem quite reasonable. @eskfung could you take a look at updating the examples as well?

from km-support.