=== Kristall Integration Plugin for WordPress === Contributors: fas27 Donate link: https://po365.ru Tags: yml, woocommerce, e-commerce, shop, print Requires at least: 3.0.1 Tested up to: 6.8.1 Stable tag: 4.0.2 Requires PHP: 7.4 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Плагин для обеспечения полной интеграции МБС Кристалл с Wordpress и Woocommerce. == Description == **МБС Кристалл** – это бизнес-система электронной модели предприятия. Она подходит для любого вида или направления деятельности бизнеса. Организует и автоматизирует работу руководителей и специалистов, помогает в режиме реального времени осуществлять управленческий учёт, контроль, автоматическое формирование документов, осуществлять сделки, вести ЭДО с контрагентами и многое другое, что крайне необходимо для осуществления деятельности и развития собственного бизнеса на современном мировом рынке товаров и услуг. *Современный бизнес не может существовать без эффективного сайта или интернет-магазина.* **Плагин Кристалл Интеграция (Kristall Integration)** – инструмент поддерживающий полную интеграцию МБС Кристалл с Wordpress и Woocommerce. **Назначение:** Быстрое создание собственной витрины Интернет-магазина товаров и услуг в сети Интернет с возможностью выгрузки на неё номенклатуры из МБС Кристалл без дополнительных рутинных действий и ручной правки карточек товара или услуг в Wordpress и Woocommerce. Полностью автоматическое осуществление продаж и регистрация заказов в МБС Кристалл. **Основные возможности:** * создание актуальных карточек товара, редактирование и удаление продуктов и категорий Вашего интернет-магазина из личного кабинета МБС Кристалл; * выгрузка товаров и услуг в «один клик» из виртуальных офисов (кабинетов) юридических лиц и индивидуальных предпринимателей из МБС Кристалл в Ваш интернет-магазин; * настройка отображения страницы продукта и вывод дополнительных данных о товаре/услуге; * интеграция с плагином Тинькофф банк для приема online платежей из платёжных систем, дебетовых и кредитных карт; * выписка счетов на оплату заказанных товаров и услуг и передача информации о них в МБС Кристалл; * упрощенное оформление заказа с минимальными необходимыми данными от покупателя; * подтверждение заказа с помощью автоматического СМС или звонка; * проверка данных покупателя на наличие связанного личного кабинета МБС Кристалл и, в случае его отсутствия, полностью автоматическая регистрация покупателя в системе с последующей аутентификацией; * полная автоматизация покупки услуг обучения/образования, с дальнейшим получением позиций заказа в личном кабинете МБС Кристалл; * осуществление продаж и учёта без необходимости контроля в личном кабинете WordPress. **Дополнительные возможности карточки товара Интернет-магазина:** * кнопка «Купить сейчас» на странице продукта; * управление вкладками на странице продукта; * шаблоны «по умолчанию» для вкладок; * вывод произвольного содержимого на странице корзины; * запрет на покупку физическими лицами товаров и услуг из избранных категорий; * полная совместимость с плагином Yoast SEO. **Задачи, которые выполняет плагин:** 1. Осуществляет интеграцию Вашего интернет-магазина на платформе WordPress + WooCommerce с такими сервисами, как: - МБС «Кристалл» (модуль Товары и Услуги) - «Тинько́фф Банк» (Интернет эквайринг) 2. Формирует актуальные трансляции (ФИДы) товаров и услуг Вашего интернет-магазина для других информационных систем, интернет-магазинов и витрин: - 2ГИС - Яндекс Бизнес - WildBerries - OZON - Instagram - Facebook - и других **в форматах:** YML XLSX WORD **и ссылок:** YML 3. Автоматически создает коммерческие предложения в формате XLS. 4. Предоставляет удобную для покупателя корзину интернет-магазина с расширенной проверкой данных. 5. Помогает создавать рекламные компании в **Яндекс Директ**, **Google Реклама** 6. Размещать рекламные компании в **Яндекс Директ** без первоначальных вложений. 7. Позволяет Вам избежать сложных технических решений. **Помощь проекту** Мы будем очень благодарны за вашу помощь проекту. Вы можете помочь следующими способами: * Отправить нам сообщение об ошибке или предложение по улучшению на [info@mbskristall.ru](mailto:info@mbskristall.ru) * Сделать перевод плагина или оптимизировать его для вашей страны. == Installation == **Требования** * Wordpress * Woocommerce ([https://wordpress.org/plugins/woocommerce/](https://wordpress.org/plugins/woocommerce/)) **Опционально** * Тинькофф Банк ([https://www.tinkoff.ru/kassa/develop/cms/](https://www.tinkoff.ru/kassa/develop/cms/)). Плагин необходим для автоматического приема платежей за продукты и услуги, без этого плагина будет доступно только выставление счетов. * Yoast SEO ([https://wordpress.org/plugins/wordpress-seo/](https://wordpress.org/plugins/wordpress-seo/)) (Плагин Кристалл Интеграция поддерживает плагин Yoast SEO из коробки, вне зависимости от порядка установки) **Рекомендовано** * Cyr-To-Lat ([https://wordpress.org/plugins/cyr2lat/](https://wordpress.org/plugins/cyr2lat/)). Или любой другой плагин для транслитерации заголовков записей и продуктов. **Установка** 1. Отключите альтернативную настройку платежей Woocommerce. Перейдите в настройки Wocommerce: WooCommerce → Настройки → Вкладка Дополнительно → Подстраница Возможности. Выключите флажок «Включите новые возможности настройки платежей». 1. *(Опционально)* Установка темы Porto ([https://themeforest.net/item/porto-responsive-wordpress-ecommerce-theme/9207399](https://themeforest.net/item/porto-responsive-wordpress-ecommerce-theme/9207399)). Плагин Кристалл Интеграция предназначен для любой темы WordPress, но наиболее полный функционал (например, кнопка «Купить сейчас») доступен для темы Porto. 1.1. Скачайте и установите тему Porto. 1.2. Настройте страницу продукта. Для этого перейдите на страницу «Porto» → «Theme Options» → «WooCommerce» → «Single Product» и выберите «Default» в секции «Product Layout». Затем найдите текстовое поле в секции «Custom Tabs Count», установите его значение в 10 и нажмите на кнопку «СОХРАНИТЬ ИЗМЕНЕНИЯ». 2. *(Опционально)* Установите плагин Тинькофф Банк. Для этого: 2.1. Перейдите по ссылке [https://www.tinkoff.ru/kassa/develop/cms/](https://www.tinkoff.ru/kassa/develop/cms/). 2.2. На странице найдите блок «WooCommerce». 2.3. Выполните установку и настройку плагина, следуя инструкции (ссылка «Инструкция.pdf»). 2.4. Перейдите на страницу «WooCommerce» → «Настройки» → «Платежи» и нажмите на кнопку «Управление» в строке Тинькофф Банк. Убедитесь, что в настройках плагина: * Опция «Признак способа расчета» выставлена в «Полный расчет»; * Опция «Признак предмета расчета» выставлена в «Платеж»; * Активирована опция автоматического перевода заказа в статус «Выполнен» после успешной оплаты. 3. Включите необходимые способы оплаты на странице «WooCommerce» → «Настройки» → «Платежи». Плагин Кристалл Интеграция поддерживает следующие виды платежей: * «Оплата при доставке» – выставление счета в МБС Кристалл для юридических лиц и ИП и добавление в корзину МБС Кристалл для физических лиц; * «Тинькофф Банк» - автоматический прием платежей за продукты и услуги с дебетовых и кредитных карт. 4. Перейдите на страницу «WooCommerce» → «Настройки» → «Товары» и отметьте опцию «Включить Ajax для кнопки добавления в корзину из архивов». Нажмите на кнопку «Сохранить». 5. Установите плагин Кристалл Интеграция. 6. Настройте выгрузку номенклатуры из МБС Кристалл на Ваш WordPress сайт (примечание: для выполнения этого пункта у Вашей учетной записи МБС Кристалл должен быть активирован доступ к разделу «Товары/Услуги» и разрешение «Выгрузка номенклатуры в WooCommerce»): 6.1. Войдите в панель администратора WordPress, перейдите на страницу «WooCommerce» → «Настройки» → «Дополнительно» → «REST API» и нажмите на кнопку «Добавить ключ». 6.2. Заполните поле «Описание» в произвольном формате и выберите свою учетную запись WordPress в поле «Пользователь». Установите опцию «Права» в значение «Чтение/Запись» и нажмите на кнопку «Генерировать ключ API». 6.3. Скопируйте значения полей «Пользовательский ключ» и «Секретный код пользователя». 6.4. Войдите в свою учетную запись МБС Кристалл и перейдите на страницу «Товары и услуги» → «WooCommerce» → «Настройки API». 6.5. В поле «URL-адрес сайта» введите URL-адрес Вашего WordPress сайта, например http://my-shop.ru. В поля «Пользовательский ключ» и «Секретный код пользователя» вставьте скопированные значения соответствующих полей из настроек добавленного API-ключа (см. 6.3). 6.6. В учетной записи МБС Кристалл, перейдите на страницу «Личный кабинет» → «Мои настройки» и скопируйте значение поля «API ключ» в секции «Настройки доступа». 6.7. Войдите в панель администратора WordPress, перейдите на страницу «Кристалл Интеграция» и вставьте в поле «API-ключ» скопированный ключ (см. 6.6). В поле «URL-адрес МБС Кристалл» введите URL-адрес МБС Кристалл, например https://mbskristall.ru. В поле «ID организации» введите ID вашей организации. Его можно найти в скобках на главной странице Вашего аккаунта МБС Кристалл, рядом с наименованием Вашей организации 6.8. Проведите настройку остальных опций плагина Кристалл Интеграция при необходимости и нажмите на кнопку «Сохранить». 7. Войдите в вашу учетную запись МБС Кристалл и перейдите на страницу «Товары и услуги» → «Мои товары/услуги» → «Номенклатура». Создайте тестовый товар и выгрузите его на Ваш сайт WordPress (кнопка «Выгрузить в WooCommerce»). 8. Проведите тестовую покупку на Вашем сайте WordPress. Если при проведении покупки произошла какая-либо ошибка, попробуйте очистить cookie и кэш сайта. Например, чтобы очистить данные сайта Google Chrome в Windows: 8.1. Откройте любую страницу Вашего WordPress сайта. 8.2. Нажмите одновременно комбинацию клавиш CRTL + SHIFT + I (английская «И»). 8.3. В открывшейся панели нажмите на вкладку «Application», затем в левой части панели выберите «Storage» и нажмите на кнопку «Clear site data». 8.4. Закройте панель и перезагрузите страницу. ***Благодарим за выбор МБС Кристалл.*** == Changelog == = 4.0.2 = * Исправлено тестовое подключению к API = 4.0.1 = * Понижена требуемая версия PHP * Обновлено описание и ссылки = 4.0.0 = * Добавлена обязательная настройка ID организации * Добавлена выгрузка вкладок * Добавлена настройка дополнительного контента = 3.2.0 = * Добавлена обработка платежа при оплате заказа = 3.1.0 = * Исправлены ошибки обработки данных при оформлении заказа = 3.0.4 = * Улучшено управление токенами = 3.0.3 = * Исправлена ошибка при установке сессии Woocommerce, скрыты некоторые поля на странице редактирования продукта = 3.0.2 = * Исправление ошибок редактора вкладок на странице редактирования продукта = 3.0.1 = * Исправление ошибок сессии Woocommerce = 3.0 = * Публичный релиз == Upgrade Notice == = 3.2.0 = Добавлена обработка платежа при оплате заказа. = 3.1.0 = Исправлены ошибки обработки данных при оформлении заказа. = 3.0.4 = Улучшено управление токенами. = 3.0.3 = Исправлена ошибка при установке сессии Woocommerce, скрыты некоторые поля на странице редактирования продукта. = 3.0.2 = Исправлены ошибки редактора вкладок на странице редактирования продукта, из-за которых отредактированный контент не сохранялся. = 3.0.1 = Исправлены ошибки сессии Woocommerce, возникающие в определенных случаях и препятствующие оформлению заказа. = 3.0 = Финальный релиз 3.0.0.