Документация

1. Описание
1.1. Общая информация
1.2. Возможности
2. Структура скрипта
2.1. Структура директорий и файлов
2.2. Структура шаблонов
3. Установка кода
3.1. Установка кода на сайт
3.2. Установка таймера/счетчика с отображением разных страниц
4. Работа с админпанелью
4.1. Создание администратора
4.2. Настройка времени
4.3. Настройка страниц
4.4. Настройка внешнего вида
5. Поддержка и другие продукты

SD Timer - это многофункциональный бесплатный таймер/счетчик обратного отсчета. Скрипт предназначен для создания на своем сайте таймера, цели установки бывают разными, это и необходимость наглядно сообщить пользователю об открытии своего проекта, проведение акций, чтобы сообщить о лимите времени. Серверная часть написана на PHP, база данных внутренняя, поэтому он может быть установлен практически на любом существующем хостинге в мире, клиентская часть имеет стандартный набор JavaScript/jQuery,HTML,CSS.

- выбор типа таймер (отсчет к указанной дате, отсчет указанного времени и специальный тип);
- поддержка cookie и IP-пользователя;
- настройка разных страниц при активном и неактивном таймере;
- настройка редирект по завершению таймера;
- настройка шаблонов;
- выбор языка для подписей;
- настройка отображаемых блоков (недели, дни, часы, минуты, секунды);
- добавление неограниченного числа счетчиков на страницу.

timer/static - статические файлы скрипта, таблицы стилей, скрипты, изображения;
timer/themes - шаблоны таймера;
timer/tools - системные файлы;
timer/tools/iddb - файлы базы данных;
timer/tools/admin.config.php - файл конфигураций админпанели;
timer/tools/config.php - файл конфигураций таймера;
timer/tools/iddb.class.php - класс для работы с базой данных;
timer/tools/timer.class.php - класс для работы с таймером;
timer/admin.php - файл админпанели
timer/js_timer.php - файл генерации JavaScript-кода при установке таймера на страницу
timer/iframe_timer.php - файл генерации страницы с рабочим таймером
timer/index.php - индексный файл, используется в случае необходимости отображения разных страниц для активного/пассивного таймера (бекап)
timer/readme.html - файл документации
index.php - индексный файл, используется в случае необходимости отображения разных страниц для активного/пассивного таймера
demo.php - демострация работы таймера

Раcсмотрим шаблон default:

timer/css - статические файлы скрипта, таблицы стилей, скрипты, изображения;
timer/css/style.css - шаблоны таймера;
timer/images - системные файлы;
timer/js - файлы базы данных;
timer/functions.js - файл конфигураций админпанели.

HTML-верстка шаблона состоит из следующих элементов:

.countdown_block - временной блок (недели, дни, часы, минуты, секунды);
.digit - стиль цифры;
.separated - разделитель между временными блоками;
.countdown_block_title - заголовок временного блока.

Код верстки блока:

<div id="countdown_block_0" class="countdown_block" data-percent="100"> 
	<div class="countdown_block_title">недель</div> 
	<div class="countdown_block_value"> 
		<span class="digit-group"> 
			<span class="digit">0</span> 
			<span class="digit">1</span> 
		</span> 
	</div> 
</div>

Чтобы установить таймер/счетчик на сайте необходимо

1. Cкачать, распаковать и загрузить папку timer в корень директории на странице которой будет расположен таймер, архив со скриптом таймера.

2. Выставить права 777 на папки:
timer/tools
timer/tools/iddb
timer/tools/iddb/value

3. Выставить права 666 на файлы:
timer/tools/admin.config.php
timer/tools/config.php
timer/tools/iddb/table.php

4. Установить в необходимом месте, где должен отображаться таймер, код:

<iframe id="timer_iframe" src="timer/iframe_timer.php" 
	frameborder="0" style="width:100%;height:100%;"></iframe>

5. Зайти в админпанель, адрес http://пусть_к_вашей_папке/timer/admin.php (например, http://www.site.ru/timer/admin.php), и настроить таймер.

Внимание! Данный метод не подходит для установки в корень сайта, если Ваш сайт работает на какой либо CMS (Wordpress, Joomla, DLE, Drupal и т.д.) и уже имеет в корневой папке файл index.php. Скрипт можно установить в какой подкаталог сайта.
Чтобы установить таймер/счетчик на сайте необходимо:

1. Cкачать, распаковать и загрузить папку timer и файл index.php в корень директории на странице которой будет расположен таймер, архив со скриптом таймера.

2. Выставить права 777 на папки:
timer/tools
timer/tools/iddb
timer/tools/iddb/value

3. Выставить права 666 на файлы:
timer/tools/admin.config.php
timer/tools/config.php
timer/tools/iddb/table.php

4. Зайти в админпанель, адрес http://пусть_к_вашей_папке/timer/admin.php (например, http://www.site.ru/timer/admin.php), и настроить таймер.

Если Вы впервые попали в админпанель таймера, ссылка http://пусть_к_вашей_папке/timer/admin.php (например, http://www.site.ru/timer/admin.php), то Вам будет предложено создать аккаунт администратора. Для этого необходимо указать желаемую пару логин/пароль и нажать кнопку "Создать". В дальнейшем, при входе, будет запрашиваться указанные Вами логин и пароль для авторизации.

Когда Вы принялись за настройку времени, первым что требуется сделать - провести настройку времени. SD Timer поддерживает три типа таймера/счетчика, это

1. Отсчет к дате - отсчет времени ведется к указанной конечной дате, больше всего подходит тем, у кого есть конечный срок выпуска продукции, окончание акции/конкурса.

2. Отсчет времени - отсчет ведется непосредственно указанного времени, например, 1 день. Отсчет индивидуален для каждого посетителя, то есть время начинает отсчитывать с момента первого посещения страницы/сайта. В данном типе таймера существует настройка Cookie и IP, это необходимо для того, чтобы при последующих заходах на сайт, таймер отсчитывался не сначала, а с учетом первого посещения.

3. Специальный - суть данного типа заключается в том, что отсчет времени ведется до указанного времени, дня недели либо числа месяца. Например, если Вам необходимо чтобы таймер постоянно отсчитывал время до 10 числа месяца, а 11 числа начинал отсчет сначала до следующего месяца, то этот тип специально для Вас.

Настройка страниц необходима в двух случаях:

1. Если необходимо, по завершению таймера, перенаправлять пользователя на другую страницу - для этого отмечаем галочкой соответствующий пункт и указываем страницу для редиректа.

2. Если необходимо отображаться разное содержимое страницы для активного таймера и оконченного - отмечаем соответствующий пункт и указываем ссылки на страницы с активным таймером (предварительно на нее устанавливаем таймер, пункт 3.1.) и без таймера, то есть страницу которая должна отображаться при выключенном таймере. Следует отметить, если данные страницы лежат в одной директории с файлом index.php таймера, пункт 3.2., то можно указать только их имена.

Среди настроек внешнего вида существует выбор шаблона, выбор языка подписей (имеется ввиду подписей "недель", "дней", "часов", "минут", "секунд") и выбор соответствующих блоков для отображения.

Контакты
facebook: https://www.facebook.com/mr.koretsky
twitter: https://twitter.com/valkorlive
сайт: https://valerykoretsky.com