Download the PHP package alorian/bxorder without Composer

On this page you can find all versions of the php package alorian/bxorder. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of alorian/bxorder

Informations about the package bxorder

Opensource Bitrix Order

Более подробную информацию по функционалу, а так же просто рассуждения на тему читайте по ссылке: https://verstaem.com/bitrix/opensource-order/

Здесь, в README.md краткая выжимка из статьи касательно функционала, но без объяснения причин.

Как установить?

Установка доступна тремя разными способами:

1. Установка через композер

Чтобы пакет скачался в нужную папку в файле composer.json укажите путь до папки bitrix. Обратите внимание на блок extra:

Путь до папки bitrix нужно прописывать относительно файла composer.json. Например если файл composer.json лежит в /local/libs, то нужно прописать "bitrix-dir": "../../bitrix". По дефолту установщик считает, что файл composer.json лежит в document_root. Если не указать корректный bitrix-dir, то будет создана папка bitrix/modules/opensource.order/ рядом с composer.json.

После того как прописали правильный bitrix-dir выполните:

После выполнения команды откройте список модулей маркетплейс в админке /bitrix/admin/partner_modules.php?lang=ru, если bitrix-dir был указан корректно, то вы увидите строку с модулем opensource.order. Нажмите "Установить" в выпадающем меню.

2. Установка из маркетплейс

Перейдите по ссылке https://marketplace.1c-bitrix.ru/solutions/opensource.order/ и установите решение как обычно. Если страница не открывается, то возможно решение еще на модерации.

3. Ручная установка

Скачайте архив https://github.com/alorian/bxorder/archive/master.zip и самостоятельно распакуйте его содержимое в папку модулей битрикса -- /bitrix/modules, либо /local/modules.

В папке модулей у вас должна быть папка opensource.order, а не bxorder-master, папку bxorder-master которая лежит в архиве необходимо переименовать. Таким образом полный путь до файла include.php у вас должен быть /bitrix/modules/opensource.order/include.php, либо /local/modules/opensource.order/include.php

После распаковки архива откройте список модулей маркетплейс в админке /bitrix/admin/partner_modules.php?lang=ru, найдите строку с модулем opensource.order и нажмите "Установить" в выпадающем меню

После установки любым из указанных способов разместите компонент opensource:order на нужной странице.

Как использовать?

Что вам нужно сделать как программисту для интеграции верстки? В самом простом случае вам всего лишь нужно сформировать форму (html тэг form) в шаблоне компонента, которая при отправке передаст на сервер пять переменных:

1. person_type_id. Переменная которая содержит тип плательщика.

2. properties[]. Массив переменных со свойствами заказа. Например, если у свойства символьный код — FIO, то атрибут name у инпута ставьте properties[FIO]. Если переменная множественная то ставьте name=properties[FIO][]

3. delivery_id. В самом простом случае это просто input типа radio, у которого атрибут name=delivery_id

4. pay_system_id. Так же как и с доставкой, просто radio инпут, только атрибут name=pay_system_id

5. save. Если переменная save=y, то компонент сохранит заказ. Во всех остальных случаях компонент просто обновит данные в объекте заказа и отдаст шаблон.

Да, всё настолько просто. Формируете форму с этими пятью переменными и вы великолепны. Это далеко не всё что можно сделать с помощью опенсорсного компонента. Но даже в самых сложных шаблонах суть останется прежней. Оформление заказа это не магия, просто обычная форма в браузере, просто чуть больше полей чем в обратной связи.

Что передается из компонента в шаблон?

Компонент формирует объект заказа и объект с коллекцией ошибок. Массив $arResult не используется.

Чтобы получить доступ к объекту заказа и коллекции ошибок в файле result_modifier.php шаблона вставьте в начало следующий код:

В шаблоне компонента желательно использовать предварительно сформированный в result_modifier массив $arResult (см. демо шаблоны). Но если вы по каким либо причинам хотите получить прямой доступ к объекту заказа, то можете сделать это так:

Куда отправлять аякс запросы?

В компоненте есть три готовых аякс метода, все они лежат в файле ajax.php. Все они работают с помощью "нового механизма аякс"

  1. searchLocation. Возвращает найденные местоположения по любой строке вида "москва", "санкт" и т.д.
  2. calculateDeliveries. Возвращает массив со стоимостью доставок
  3. saveOrder. Сохранение массива аяксом. Для работы нужно сериализовать все поля формы и отправить.

Как дорабатывать компонент под проект?

Во первых, вы всегда можете отправить pull request. Если там будет код, который пригодится многим, то pull request будет влит в основную ветку. Таким образом вы будете пользоваться оригинальным компонентом, без каких либо доработок.

Во вторых, вы можете использовать систему событий битрикс. Наиболее полезным я думаю будет событие OnSaleOrderBeforeSaved.

В третьих, вы можете использовать возможность наследования компонентов. В наследованном компоненте пишете любой нужный под проект функционал, и при этом не теряете совместимость с оригинальным компонентом. Шаблон компонента у вас в любом случае будет свой.

Куда отправлять ошибки и предложения?

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

All versions of bxorder with dependencies

PHP Build Version
Package Version
Requires php Version ^7.0
composer/installers Version ~1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package alorian/bxorder contains the following files

Loading the files please wait ....