Hi Saint Script - Official Documentation

Welcome to the Hi Saint setup guide. This script provides a simple, plug-and-play way to display a floating daily quote to enlighten your users. It requires zero configuration and guarantees the popup only triggers once a day per visitor.

Installation Guidelines

Installing "Hi Saint" takes less than a minute. Follow these two simple steps:

Step 1: Upload the file

Place the hi-saint.php file into your website's root directory or an includes folder.

Step 2: Include the script

You can include the script anywhere on your PHP pages. Because "Hi Saint" uses JavaScript's Local Storage instead of PHP headers/cookies to track the 24-hour cycle, you will never run into the dreaded "headers already sent" error. Drop it in the header, footer, or middle of the body.

<?php include 'hi-saint.php'; ?>

        Pro Tip: For the best performance and cleanest code organization, we recommend placing the include statement just before your closing </body> tag.
    

Customizing the Quotes

To add or change the quotes, open hi-saint.php in a text editor. Look for the $saints_quotes array near the top of the file.

$saints_quotes = [
    "\"Your new quote here.\" – Saint Name",
    "\"Another quote here.\" – Saint Name"
];

Simply add your quotes to the list wrapped in double quotes and separated by commas.

How the Logic Works

Server-Side: PHP selects a random quote from the array upon page load and securely injects it into the HTML structure.
Client-Side: JavaScript checks the browser's localStorage for today's date. If the dates match, the box stays hidden. If it's a new day, the box is revealed and the current date is logged.