bikeportal.org.ua

Загрузка протоколов в базу bikeportal.org.ua

Для того чтобы добавить протокол в базу его нужно подготовить в формате CSV (разделители точка с запятой) по определенному шаблону. 

В архиве protocol_instruction.rar есть файл results4csv.xls – это шаблон протокола в excel. В нем определен формат и расположение столбцов в выходном документе CSV. Расположение столбцов менять нельзя, программа импорта жестко привязана к последовательности столбцов!!! 

В шаблоне:
Первая строка – названия столбцов. Эту строку удалять нельзя! В этой строке необходимо указать максимальное количество кругов которые есть в протоколе (у категории, которая проехала больше всего кругов) добавив (или удалив) соответствующее количество столбцов в конце: «Круг1», «Круг2» итд…

С 14.07.2013 время кругов можно указывать с точность до миллисекунды. Для этого формат данных в ячейке должен быть следующий:
ч:мм:сс,000
где ч - часы, мм - минуты, сс - секунды, 000 - миллисекунды.
Причем формат миллисекунд может быть любой точности: "ч:мм:сс,000" или "ч:мм:сс,00" или "ч:мм:сс,0".

Для гонок point-to-point гонок или гонок с 1м кругом, указывайте количество кругов = 1, и Круг1 = время участника. Скрипт формирования протокола оформит эти результаты как надо, без указания времен кругов. 

По названиям столбцов, вроде бы понятно, какая информация там должна быть. Просто копируйте данные из вашего протокола в соответствующие столбцы шаблона. Если в вашем протоколе нет каких-либо данных (например «Велосипед» или «Команда»), то оставляйте этот столбец пустым – скрипт формирования протокола исключит его из таблицы при выводе.

Столбец номер 5 (E) содержит имя гонщика в формате «Фамилия Имя», столбцы 6 и 7 (F и G) могут содержать отдельно Фамилию и Имя (столбцы 6 и 7 могут быть пустыми). Если в исходном CSV столбцы «Фамилия» и «Имя» не пустые, то в базу кладутся данные именно из этих столбцов. Если они пустые - скрипт возьмет фамилию и имя из столбца 5 (Е).

Обязательно заполнить столбец «Категория» - в каждой строке должна быть указана категория участника.

Столбец «Кол-во человек команде» - заполняется для гонок, в которых учувствует команда из нескольких человек. Если это обычная гонка – можно оставить пустым или же написать 1. Если это эстафета – необходимо прописать кол-во человек в команде (как в примере 080907_XCM_dk_v6.csv).

Столбец «userid» - содержит идентификатор пользователя на сайте. Пока вы его не знаете, оставляете пустым.

Столбец «Номер» - номер, под которым участник стартовал в гонке. Можно оставить пустым, если такой информации нет.

После того как заполнили все данные, сохраняем документ в формате CSV.

В excel’е выбираем «сохранить как» и формат «CSV (разделители – запятые)», который сохраняет в нужный нам формат «CSV (разделители – точка с запятой)» в кодировке windows-1251

В архиве есть папка «примеры» - в ней лежат протоколы подготовленные к загрузке, исходники в xls и готовые csv. Я думаю должно быть все понятно, разобраться можно легко!...

После того как сформировали файл, заходим на bikeportal.org.ua в раздел гонки. В блоке «Информация», кликаем «Добавить результаты», или же, если вы добавляете протокол гонки, для которой не создан раздел на сайте, выбираете меню: «Соревнования – Добавить протокол в базу». Заполняем данные о гонке, выбираем сформированный файл и загружаем протокол. В описании гонки есть параметр "Alias гонки" - это ключевое слово, по которому можно будет выбрать определенные этим alias'ом гонки.

После загрузки появится страница, на которой можно выбрать соответствие людей из протокола и пользователей на сайте. Первичная выборка соответствия осуществляется по имени и фамилии или же по нику. Поэтому важно чтобы в протоколе (и в базе пользователей на сайте) были нормально написанные имя и фамилия, которые бы соответствовали друг другу (а не «Саша» и «Александр», «Дима» и «Дмитрий» итп) – это здорово упрощает вашу работу и работу скрипта

Нажимаете «Обновить».

Все. Протокол в базе. Его можно редактировать (это может делать только человек его загрузивший) – задавать соответствие людей в протоколе и на сайте и можно заново загрузить протокол (старые данные будут удалены).

При регистрации на сайте нового пользователя запускается скрипт, который ищет человека по ФИО и нику в протоколах и автоматом выставляет соответствие. Поэтому и была просьба вводить данные при регистрации не абы как или латиницей, а красиво!  

Вставка протокола в статью

Протоколы из базы результатов можно вставлять в любые статьи на сайте. Для этого, в тот месте, где вы хотите разместить протокол, вставьте такую строчку:

{jumi [plugins/content/jumi/listrace.php][raceid][hide][rcatid][count][graph]}

где:
raceid - идентификатор гонки (число), его можно посмотреть в списке протоколов - столбец ID
hide - если равно 1 - скрыть дополнительные столбцы, равно 0 - показать доп. столбцы (по умолчанию 1)
rcatid - порядковый номер категории, по которой выдать протокол (по умолчанию 0 - все категории)
count - если равно 1 - показать список городов в конце, равно 0 - не показывать список городов (по умолчанию 1)
graph - если равно 1 - показать после таблицы график позиций, равно 0 - не показывать график (по умолчанию 1)

обязательный столбец - raceid, остальные можно не указывать...

Для автоматизации этого процесса, внизу окна редактирования есть кнопка "Протокол из базы" - при нажатии на нее нужно будет только лишь ввести идентификатор гонки (ID) и в статью поместится нужный скрипт!!!

Формирование ссылки на протокол

Стандартная ссылка на протокол выглядит так:

http://bikeportal.org.ua/index.php?option=com_content&view=article&id=94&raceid=72

в ссылке можно задать дополнительные параметры:

http://bikeportal.org.ua/index.php?option=com_content&view=article&id=94&raceid=72&hide=0&rcatid=2&count=0

значения raceid, hide, rcatid и count такие же как и в описанном выше "Вставка протокола в статью" 

Вставка протокола отрывов по кругам в статью

В тот месте, где вы хотите разместить протокол, вставьте такую строчку:

{jumi [plugins/content/jumi/listrace_laps.php][raceid][rcatid][graph]}

где:
raceid - идентификатор гонки (число), его можно посмотреть в списке протоколов - столбец ID
rcatid - порядковый номер категории, по которой выдать протокол (по умолчанию 0 - все категории)
graph - если равно 1 - показать после таблицы график позиций, равно 0 - не показывать график (по умолчанию 1)

обязательный столбец - raceid, остальные можно не указывать...

Формирование ссылки на протокол отрывов по кругам

Стандартная ссылка на протокол выглядит так:

http://bikeportal.org.ua/index.php?option=com_content&view=article&id=348&raceid=72

в ссылке можно задать дополнительные параметры:

http://bikeportal.org.ua/index.php?option=com_content&view=article&id=94&raceid=72&rcatid=2&graph=0

значения raceid, rcatid и graph такие же как и описанные выше 

Вставка протокола «Лучший круг» и  «Лучший средний круг» в статью

В тот месте, где вы хотите разместить протокол, вставьте такую строчку:

{jumi [plugins/content/jumi/listrace_min.php][mid][raceid][hide]}

где:
mid - если равно 0 - показать «Лучший круг», равно 1 - показать «Лучший средний круг» (по умолчанию 0)
raceid - идентификатор гонки (число), его можно посмотреть в списке протоколов - столбец ID
hide - если равно 1 - скрыть дополнительные столбцы, равно 0 - показать доп. столбцы (по умолчанию 1)

обязательные столбцы –  mid и raceid, hide можно не указывать...

Формирование ссылки на протоколы лучшего круга

Стандартная ссылка на протокол выглядит так:

Для «Лучший круг»: http://bikeportal.org.ua/index.php?option=com_content&view=article&id=350&raceid=72
Для «Лучший средний круг»: http://bikeportal.org.ua/index.php?option=com_content&view=article&id=351&raceid=72

в ссылке можно задать дополнительные параметры:

http://bikeportal.org.ua/index.php?option=com_content&view=article&id=94&raceid=72&mid=1&hide=0

значения raceid, hide, rcatid и count такие же как и описанные выше

Вставка протокола «Виртуальный общий зачет»

В тот месте, где вы хотите разместить протокол, вставьте такую строчку:

{jumi [plugins/content/jumi/listrace_all.php][raceid][hide]}

где:
raceid - идентификатор гонки (число), его можно посмотреть в списке протоколов - столбец ID
hide - если равно 1 - скрыть дополнительные столбцы, равно 0 - показать доп. столбцы (по умолчанию 1)

обязательный столбец –  raceid, hide можно не указывать...

Формирование ссылки на «Виртуальный общий зачет»

Стандартная ссылка на протокол выглядит так:

http://bikeportal.org.ua/index.php?option=com_content&view=article&id=352&raceid=72

в ссылке можно задать дополнительные параметры:

http://bikeportal.org.ua/index.php?option=com_content&view=article&id=352&raceid=72&hide=0

значения raceid, hide такие же как и описанные выше