Янв
Читать мануалы бывает полезно, а бывает и дюже необходимо. Не сочтите за труд и ознакомьтесь с данным манускриптом, дабы исключить большинство вопросов к автору труда, после вашего решения использования программы. Программный продукт не является мертвым кодом, пылящимся среди других многотомных архивов автора, а есть работающая тулза, испытанная временем и однозначно работающая на благо автора и по явно задуманному им алгоритму. А иначе, зачем бы оно всё это?
Если хостер автору попался правильный, и программа работает как задумано, то это не значит, что в программном коде нет ошибок. Буду очень признателен всем, кто отзовется по поводу работы скрипта, и будет сообщать о найденных ошибках в коде или работе программы.
Итак, приступим.
Состав скрипта.
Разархивируйте архив и откройте папку afflinks_v***. Она является каталогом актуальной версии скрипта и её саму загружать никуда не надо.
На самом деле файлов в папках больше, а здесь намеренно показаны только те файлы, которые требуют обратить на себя внимание.
Файлы выделенные жирным шрифтом, должны быть в корне сайта, остальное в соответствующих папках.
Файлы и папки выделенные закрашиванием, можно переименовывать, не меняя расширения файлов. Об этом чуть позже.
Файлы выделенные подчёркиванием, требуют редактирования. Об этом далее.
Создание базы данных.
Так как скрипт использует базу данных MySQL, то явно требуется создать себе такую базу.
Для человека проделывающем такие действия хотя бы изредка ничего трудного в этом ритуале нет, для непосвященных же, буду снабжать описание дополнительной инфой в виде комментариев в скобках.
Заходим в гости к хостеру (админка вашего аккаунта у хостера) и создаем новую базу данных (саму базу, пользователя базы). Берем от неё пароли и другие атрибуты соединения.
Заходим в управление базами данных (phpMyAdmin) и открываем нашу базу. Пока она пустая, но это сейчас неважно. Находим пунктик меню «Операции» и в открывшемся окне смотрим «Сравнение:» - надо выставить utf8_general_ci, если там что-то другое. Сохраняем, если была другая кодировка и идем редактировать наши файлы.
Редактирование файлов, перед загрузкой.
Теперь приступим к редактированию некоторых файлов скрипта. Желательно для внесения данных в файлы скрипта использовать редакторы не вносящие лишнего в код и не изменяющие кодировку при открытии/сохранении/закрытии этих файлов. К таковым можно отнести notepad2, Notepad++ и др. Далее открываем файл connect.php из папки admin. В нём с подробными комментариями находим то, что требует изменений, а именно:
$host="localhost"; // Имя хоста
$bdname="affiliate_links"; // Имя БД
$bdlogin="affiliate_links";// Логин к БД
$bdpassword="test"; // Пароль к БД
И вставляем свои данные в соответствующие места, между двойными кавычками (значения переменных).Для тех, кто впервые правит файлы с расширением .php. Все что находится в строке после двойного слеша «//» является комментарием и никак на работе самого файла не отражается. Переменной является выражение с таким значком $ вначале (например $host), а все что после равно (присваивание значения переменной) между кавычками (одинарными или двойными, в зависимости от типа) является значением переменной.
Имя хоста по обыкновению должно быть localhost. Если у вашего хостера на этот случай есть своё мировоззрение, то посему обращайтесь к нему и решайте что туда вписывать, если не localhost.
Соответствующие изменения надо сделать и в файле addblock.php. Замечу, что в этом файле переменные для соединения с вашей БД имеют другой вид.
Далее в файле connect.php видим:
$scriptdir="aflinks"; // Директория скрипта
$aflinks_cp_enter="_affadmin.php";// Название файла для входа в Админку скрипта. При изменении не забудьте переименовать файл скрипта!
$pl="pl/"; // Виртуальная папка для реддиректа. При изменении необходимо в файле .htaccess (в корне сайта) в выражении "^(.+)/pl/(.+)$" pl заменить на свое название виртуальной папки
$uploaddir="pi/"; // Обязательная директория. Папка загрузки рекламных изображений. Все загруженные скриптом или вручную файлы помещаются в эту папку
// КОРНЕВОЕ РАСПОЛОЖЕНИЕ ВЕБ-САЙТА
$rootdir=$HTTP_SERVER_VARS["DOCUMENT_ROOT"]; // Возможно, придётся изменить на
#$rootdir="/home/test.ru/www"; // что-то типа этого
$scriptdir="aflinks"; - это директория (папка) скрипта. Если решите поменять название директории скрипта, то соответственно переименуйте папку.$aflinks_cp_enter="_affadmin.php"; - Это однозначно подлежит переименованию. Вход в админку должен быть ни как у всех, поэтому не обсуждается. Сам файл _affadmin.php тоже подлежит переименованию. Не меняйте только само расширение - .php.
$pl="pl/"; - виртуальная папка реддиректа ссылок. При переименовании не забывайте про слеш на конце (он однозначно должен здесь присутствовать). При переименовании необходимо в файле .htaccess (в корне сайта) в выражении "^(.+)/pl/(.+)$" pl заменить на свое название виртуальной папки.
$uploaddir="pi/"; - Обязательная директория (слеш на конце тоже). Папка загрузки рекламных изображений. Все загруженные скриптом или вручную файлы помещаются в эту папку. Принципиально – если вы переименуете эту папку, то придётся править дефолтный дамп базы, прежде чем его прописывать в базу данных. Это не трабла, а необходимость для уникальности имён в ссылках на изображения. Кому сей момент непонятен, смело оставляйте как есть, и не будет лишних телодвижений с правкой дампа БД.
$rootdir=$HTTP_SERVER_VARS["DOCUMENT_ROOT"]; - если скрипт напрочь откажется закачивать изображения туда, куда положено ему, то придётся задокументировать эту строку (поставить вначале строки значок решетки #) и идти к хостеру на поклон, для отыскания корневого пути до сайта. Отыскав нужную информацию, следует её указать в следующей строке, естественно раздокументировав её (убрать значок решетки # из начала строки).
#$rootdir="/home/test.ru/www"; .
Сохранить все редактируемые документы.
Импорт дампа в БД.
Теперь можно перейти к дампу базы. Если вы решили иметь уникальные ссылки на изображения (переименовали папку для изображений). Откройте файл affiliate_links.sql и найдите в нём следующие строки:
--
-- Дамп данных таблицы `images`
--
INSERT INTO `images` VALUES (1, 10, 'pi/', '120x600_670_ru.png', 'png', '120', '600', '2013-01-02 14:22:49');
INSERT INTO `images` VALUES (2, 10, 'pi/', '200x200_10_ru.gif', 'gif', '200', '200', '2013-01-02 14:22:49');
INSERT INTO `images` VALUES (3, 15, 'pi/', '200x200_ru.gif', 'gif', '200', '200', '2013-01-02 14:22:49');
INSERT INTO `images` VALUES (4, 11, 'pi/', '250x250_70_ru.swf', 'swf', '250', '250', '2013-01-02 14:22:49');
INSERT INTO `images` VALUES (5, 10, 'pi/', '468x60_18_ru.gif', 'gif', '468', '60', '2013-01-02 14:22:49');
INSERT INTO `images` VALUES (6, 13, 'pi/', 'rbfx10_200x200_ru.gif', 'gif', '200', '200', '2013-01-02 14:22:49');
INSERT INTO `images` VALUES (7, 20, 'pi/', 'sm_2.gif', 'gif', '486', '60', '2013-01-02 14:22:49');
INSERT INTO `images` VALUES (8, 5, 'pi/', 'tech_of_trading_468x60.gif', 'gif', '468', '60', '2013-01-02 14:22:49');
INSERT INTO `images` VALUES (9, 7, 'pi/', '~(468x60).gif', 'gif', '468', '60', '2013-01-02 14:22:49');
Все pi в дампе таблицы `images` следует заменить своими именами папки (слеш там уже есть).Сохранить изменения и после этого уже можно прописывать дамп базы в саму базу.
Идем опять в гости к хостеру, в управление базами данных в раздел phpMyAdmin. Открываем нашу базу, и делаем запрос на «Импорт в базу данных». Если Вы выполнили действия из "Создание базы данных" (установили "Сравнение" в utf8_general_ci), то нижеописанные действия не должны породить кучу кркозябров (несоответствие кодировок) ни в БД, ни при выводе данных на сайт. Если не выполнили, то это сделать можно перед импортом дампа.
В открывшемся окне
«Импортируемый файл»:
Обзор вашего компьютера - указываем путь до файла дампа базы данных
Кодировка файла - указываем кодировку файла (utf-8)
«Формат»: SQL
«Параметры формата»:
Режим совместимости SQL – NONE.
И жмете «OK». Если система сообщит об ошибках, это может означать, что сервер БД вашего хостера, что-то непонятное разглядел в дампе. Это вполне естественный процесс при несоответствии кодировок и других случаях с возможными изменениями кода в импортируемом файле при помощи кривых рук и неправильных редакторов. Если система сообщит об успешном создании таблиц в базе, то откройте (обзор) таблицу affiliate, в колонке ancor - посмотрите как выглядят русские тексты. Если там все нормально, то данные прописаны в БД правильно и всё будет отображаться, так как надо.
Если вместо русских букв и слов стоят знаки вопроса, другие закорючки или вообще пусто, то это значит, что вы не выполнили настройки базы как было описано выше, или настройки сервера БД вашего хостера не дают вам это сделать.
В этом случае удалите все таблицы из базы данных и проверьте настройки заново. А потом повторите импорт дампа базы. Если это не помогло, то ищите инфу по настройке баз у вашего хостера, или стучитесь к нему в саппорт. Большинство современных хостеров в конструкциях своего программного обеспечения должны поддерживать кодировку utf-8. Если же этого не наблюдается, то ваш хостер не совсем для вас правильный, и возможные потуги ваших переговоров на тему его вменяемости в большей степени бесполезны.
Загружаем все папки с содержимым на сервер.
Загрузка файлов архива осуществляйте по ftp.
Загружайте все папки и файлы на сервер, не меняя структуры.
Файлы .txt .php .js .css .htaccess – загружаем в текстовом формате (ascii), файлы картинок – загружаем в бинарном (bin) режиме.
Права доступа по умолчанию: на все папки – 755, на файлы – 644.
Когда закачаете все файлы на сервер, проверьте работоспособность сайта. Наберите в браузере адрес https://вашдоме.ру/aflinks/_affadmin.php, если вы не изменяли ни директорию, ни файл входа в админку скрипта. Если поменяли, то набирайте соответствующий адрес.
Авторизируйтесь под логином и паролем – admin. После входа «прогуляйтесь» по пунктам меню и убедитесь, что все страницы нормально открываются, а информация на них отображается в правильной кодировке.
Оставьте свой комментарий