Skip to content
Permalink
Browse files

Merge branch 'free' of https://github.com/active-programming/mycityse…

…lector into free

# Conflicts:
#	README.md
#	cookbook/configure_domain.md
  • Loading branch information...
Konstantin Kutsevalov
Konstantin Kutsevalov committed Jul 19, 2018
2 parents 83f6a61 + 0be36ce commit 97526ef992e2a0a5e00a93afdeca83b965a24e14
Showing with 109 additions and 20 deletions.
  1. +37 −18 README.md
  2. +6 −2 cookbook/configure_domain.md
  3. BIN doc_images/image-1.jpg
  4. BIN doc_images/image-1.png
  5. +46 −0 loader.md
  6. +20 −0 mcs_update.xml
@@ -2,19 +2,19 @@ My City Selector Joomla Extension
=================================

Package: component + module + plugins<br>
Version: 2.0.25
*для получения расширенной версии (без ограничений) просьба писать на konstantin(dog)kutsevalov(dot)name или vlad[at]smolensky(dot)info*

##Системные требования

Joomla >= 3.3.0<br>
PHP >= 5.5
Joomla >= 3.3.0 (последний тест на 3.8.8)<br>
PHP >= 5.6<br>
PHP Extension [ionCube](http://jbzoo.ru/docs/ioncube-installing)

## Общие сведения

My City Selector (MCS) - это расширение для CMS Joomla, позволяющее отображать разную информацию для разных городов.

<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/master/doc_images/image-1.jpg" alt="" />

<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/free/doc_images/image-1.jpg" alt="" />

В новой 2й версии основной упор сделан на использование поддоменов для разных городов, так как это самый
лучший способ разделять контент с точки зрения поисковиков.
@@ -28,10 +28,9 @@ My City Selector (MCS) - это расширение для CMS Joomla, позв
Скачиваете отсюда: https://github.com/art-programming-team/mycityselector/releases
(Предыдущая версия 1.8 доступна здесь https://github.com/art-programming-team/mycityselector/tree/v1.8.x/builder/package)
Расширение включает в себя два плагина (system/plgmycityselector & editors-xtd/mcsinsert), компонент (com_mycityselector) и модуль (mod_mycityselector). Все они ставяться одним пакетом,
поэтому загруженный архив распаковывать не нужно. Устанавливайте как есть.
Помимо самого расширения, вам потребуется установленный php модуль [ionCube](loader.md).
## Настройка
@@ -40,7 +39,7 @@ My City Selector (MCS) - это расширение для CMS Joomla, позв
- Включить модуль "My City Selector MOD" и настроить его.
- Прописать в настройках компонента "MyCitySelector" базовый домен вашего сайта.
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/master/doc_images/config.jpg" alt="" />
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/free/doc_images/config.jpg" alt="" />
После чего, при определенном уровне удачи все должно заработать :)
@@ -61,17 +60,25 @@ kiev.krakozyabra.org<br>
Управление текстами происходит через компонент MyCitySelector в админке, там же и управление
списком городов и настройки компонента.
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/master/doc_images/image-2.png" alt="" />
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/free/doc_images/image-2.png" alt="" />
Часть настроек находится в модуле, который отвечает за отображаемое окно выбора города на сайте.
Для вставки заготовленных текстов на страницы сайта используются специальные маркеры (теги).
Всего есть два вида маркеров:
Всего есть три вида маркеров:
- [city Город] текст [/city] - из первой версии
- {mcs-N} - новый маркер, появился во второй версии.
- {city_name} - спец. маркеры позволяющие выводить название города в мета теги (подробнее ниже)
Еще, Вы можете получить название текущего города в своем коде черезе команды
```
$cityCode = McsData::get('city');
$cityName = McsData::get('cityName');
```
Тег [city] удобен для небольших надписей или сообщений (и для небольшего количества городов).
Итак, тег [city] удобен для небольших надписей или сообщений (и для небольшего количества городов).
Но если городов много и информация для каждого своя, то лучше воспользоваться компонентом
MSC в админке. Основной недостаток этих тегов в том, что на одной странице все теги взаимосвязаны
и отобразить разную информацию в нескольких местах страницы может быть невозможным.
@@ -91,13 +98,13 @@ MSC в админке. Основной недостаток этих тегов
и у каждого свои условия по городам. Кроме того, вам не нужно вводить их вручную.
В редакторе Вы можете найти кнопку для вставки маркера в текущую позицию курсора.
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/master/doc_images/image-3.jpg" alt="" />
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/free/doc_images/image-3.jpg" alt="" />
Просто выбираете нужный контент из списка и вставляете маркер в текст. Все просто.
Выбираете нужный контент из списка и вставляете маркер в текст. Все просто.
Перейдем к рассмотрению компонента "MyCitySelector". Откройте подпункт "Страны".
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/master/doc_images/image-5.png" alt="" />
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/free/doc_images/image-5.png" alt="" />
При клике по ссылке "регионы" вы сможете открыть список регионов, относящихся к данной стране. Аналогично и в списке
регионов, так есть ссылка "города". Делая элементы списков неактывными, вы запрещаете их отображение в окне выбора города.
@@ -108,7 +115,7 @@ MSC в админке. Основной недостаток этих тегов

Перейдем к управлению текстами. Что тут у нас...?

<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/master/doc_images/image-6.jpg" alt="" />
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/free/doc_images/image-6.jpg" alt="" />

эммм...ну тут собственно пусто. Самое время что-нибудь создать. Предположим (совершенно точно), нам нужно для разных
городов отображать разные адреса и контакты.
@@ -117,9 +124,21 @@ MSC в админке. Основной недостаток этих тегов
кнопкой "Добавить поле". В добавленное поле вбиваем желаемый город и вводим для него
текст (адрес).

<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/master/doc_images/image-7.jpg" alt="" />
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/free/doc_images/image-7.jpg" alt="" />

## Специальные маркеры

Как было сказано выше имеются дополнительные маркеры, позволяющие выводить название города в title или meta тегах.
Вот их полный перечень:

- {city_name} или {cityName} (как больше нравится) => Именительный (Омск)
- {city_name2} или {cityName2} или {cityGenitive} => Родительный (Омска)
- {city_name3} или {cityName3} или {cityDative} => Дательный (Омску)
- {city_name4} или {cityName4} или {cityAccusative} => Винительный (Омск)
- {city_name5} или {cityName5} или {cityAblative} => Творительный (Омском)
- {city_name6} или {cityName6} или {cityPrepositional} => Предложный (Омске)

Эти маркеры можно использовать как в шаблоне так и в полях ввода при редактировании контента.

## Кастомизация

@@ -156,8 +175,8 @@ server {
... other instructions ..
location /robots.txt {
rewrite "^.*+$" /components/com_mycityselector/robots.txt.php;
location = /robots.txt {
rewrite ^(.*)$ /components/com_mycityselector/robots.txt.php last;
}
}
```
@@ -5,7 +5,7 @@
Для начала, вам неоходимо иметь доступ в DNS записям вашего домена.
Там нужно сохдать А запись такого вида:

<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/develop/doc_images/domain-1.jpg" alt="" />
<img src="https://raw.githubusercontent.com/art-programming-team/mycityselector/free/doc_images/domain-1.jpg" alt="" />

Эта запись будет перенаправлять лобой запрошенный поддомен на тот же сервер где и основной сайт.

@@ -40,4 +40,8 @@ server {
После обновления DNS записей и перезагрузки веб сервера, все должно заработать как нужно.
Какой поддомен Вы бы не ввели (хоть figace.site.ru), запрос все равно будет уходить на основной сайт site.ru.

**Если у Вас есть пример настроек для конкретного сервера или хостера, милости просим [делиться](https://github.com/active-programming/mycityselector/issues/new)**
<<<<<<< HEAD
**Если у Вас есть пример настроек для конкретного сервера или хостера, милости просим [делиться](https://github.com/active-programming/mycityselector/issues/new)**
=======
**Если у Вас есть пример настроек для конкретного сервера или хостера, милости просим [делиться](https://github.com/active-programming/mycityselector/issues/new)**
>>>>>>> 0be36ce3757a20f4dba1d69eea040756f034bde8
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,46 @@
Для использования закодированных и защищенных с помощью ionCube PHP-файлов требуется чтобы на вашем веб-сервере был установлен загрузчик ionCube.

Возможна автоматическая установка с помощью мастера установки.
Вы можете скачать его на странице (Loader Installer: ZIP):
[https://www.ioncube.com/loaders.php](https://www.ioncube.com/loaders.php)

Или по прямой ссылке (для Windows):
[https://www.ioncube.com/loader-wizard/loader-installer.zip](https://www.ioncube.com/loader-wizard/loader-installer.zip)

Возможна автоматическая установка с помощью мастера установки. Вы можете скачать его на странице (Loader Installer: ZIP):
[https://www.ioncube.com/loaders.php](https://www.ioncube.com/loaders.php)
Или по прямой ссылке (для Windows):
[https://www.ioncube.com/loader-wizard/loader-installer.zip](https://www.ioncube.com/loader-wizard/loader-installer.zip)

Распакуйте и запустите файл из архива, следуйте дальнейшим указаниями мастера.

Если вы разбираетесь в настройке вашего сервера, вы можете сделать это самостоятельно:
1. Скачайте пакет с модулем для вашей операционной системы на странице [https://www.ioncube.com/loaders.php](https://www.ioncube.com/loaders.php) (раздел Loader Downloads) и разархивируйте его.
2. Затем вам нужно узнать версию PHP установленную на вашем сервере, для этого зайдите в административную панель Joomla, нажмите `Система -> Информация о системе`. На этой странице найдите запись (пример):

Версия PHP 7.0.20-2~ubuntu16.04.1+deb.sury.org+1
Обратите внимание на первые две цифры после PHP - это номер вашей версии, в данном примере 7.0
На этой же странице перейдите во вкладку `"Информация о PHP"` и найдите строку Thread Safety disabled (или Thread Safety enabled), запомните это значение.
3. Перейдите в папку куда вы распаковали модуль, вам нужно выбрать файл согласно вашей версии PHP и режиму Thread Safety. Если параметр Thread Safety включен (enabled), то вам нужен файл, оканчивающийся на _ts.so
Скопируйте этот файл на ваш сервер в папку, например `/usr/lib/php/`
4. Найдите где располагается ваш конфигурационный файл на сервере, для этого на странице "Информация о PHP" найдите строку Loaded Configuration File, рядом будет указано расположение файла настроек, например `/etc/php/7.0/fpm/php.ini`, откройте его любым редактором, например
nano /etc/php/7.0/fpm/php.ini
и добавьте в самом конце строку
zend_extension = /usr/lib/php/имя файла загрузчика
например:
zend_extension = /usr/lib/php/ioncube_loader_lin_7.0.so
*в указанном примере библиотека для версии PHP 7.0 ОС Linux*
Сохраните файл настроек, выйдите из редактора и перезапустите ваш веб сервер.
5. Теперь нужно проверить что модуль загружен и функционирует, для этого снова зайдите в административную панель Joomla, `Система -> Информация о системе -> Информация о PHP`, на странице вы должны найти информацию вида
with the ionCube PHP Loader (enabled) + Intrusion Protection from ioncube24.com (unconfigured) v6.0.9, Copyright (c) 2002-2016, by ionCube Ltd.
*(версии могут отличаться)*
Вы всегда можете попросить нас о помощи в установке через форму обратной связи на сайте https://act-prog.ru/contacts
@@ -0,0 +1,20 @@
<updates>
<update>
<name>Mycityselector</name>
<description>Mycityselector Component for Joomla</description>
<element>pkg_mycityselector</element>
<type>package</type>
<client>0</client>
<version>2.0.40</version>
<infourl title="MyCitySelector">https://github.com/active-programming/mycityselector</infourl>
<downloads>
<downloadurl type="full" format="zip">https://act-prog.ru/product/mcs-download</downloadurl>
</downloads>
<tags>
<tag>alpha</tag>
</tags>
<maintainer>Konstantin Kutsevalov and Vladislav Smolenskiy</maintainer>
<maintainerurl>https://github.com/active-programming/mycityselector/graphs/contributors</maintainerurl>
<targetplatform name="joomla" version="3.[0123456789]"/>
</update>
</updates>

0 comments on commit 97526ef

Please sign in to comment.
You can’t perform that action at this time.