citripio/toolbelt

Helpers for citripio websites

Citripio Toolbelt

Helpers for contentor websites in PHP, _(*1)

Development

Follow these steps in order to publish a new version., _(*2)

Remember to always push your commits first, and then create the new version number tag:, _(*3)

git commit -m "Some meaningful comment"
git push
git tag -a 1.0.0 -m "Version 1.0.0"
git push --tags

After a few seconds, the new version will show up on Github and Packagist, _(*4)

Installation

Add this to your composer.json, _(*5)

{
    "require": {
        "citripio/toolbelt": "^1.0"
    }
}

Then:, _(*6)

require_once "./vendor/autoload.php";

$utils = new Citripio\Toolbelt();

Methods

get_content_part($content, $tag)

Receives a string and parses it for the given <tag></tag> name., _(*7)

include_utms()

Useful for redirects., _(*8)

Receives a URL and returns it appending the current utm_source and utm_campaign GET parameters, if present. Doesn't add an extra ? to the URL if it already has one., _(*9)

save_user_token_and_session_in_cookies()

Receives no arguments. Useful for normalizing the cookie's name., _(*10)

save_content_list_timestamps_in_cookies()

Receives a collection of contents[] containing a created_at_timestamp key. Saves a id => timestamp list to cookies, returning that same list., _(*11)

retrieve_saved_timestamp_for_content_id()

The opposite of save_content_list_timestamps_in_cookies., _(*12)

Receives a content list and an ID. Returns the timestamp for that ID., _(*13)

generate_content_md5()

Receives a string or integer. Generates a MD5 hash using always the same salt., _(*14)

get_verse_code()

Receives a string and parses it for <verse_code>, _(*15)

get_verse()

Receives a string and parses it for <verse>, _(*16)

get_explanation()

Receives a string and parses it for <explanation>, _(*17)

get_prayer_intro()

Receives a string and parses it for <prayer_intro>, _(*18)

get_prayer()

Receives a string and parses it for <prayer>, _(*19)

substring_words($text, $length)

Receives a string and an integer. Performs a substr() keeping whole words and adding "..." in case the result doesn't end with "." or ",", _(*20)