Giter Club home page Giter Club logo

bxapidocs's Introduction

bxApiDocs

bxApiDocs призван упростить, не самую сладкую, жизнь разработчику 1С-Битрикс

Это сама по себе папка с модулями /bitrix/modules/, 1С-Битрикс: Управление сайтом - Бизнес, но с убранными лишними файлами и папками (не .php, без классов методов, констант и т.д.), добавленными константами, событиями и хелпами phpDocs.

Что умеет

Сам по себе ничего не умеет, но содержит несколько крупных вкусностей, что в комплекте с IDE колоcально облегчает жизнь разработчику (расхолаживает, обленяет и т.д. - так что будьте осторожны).

Фичи

  • В общем-то само API, со всеми phpDocs’ами, что удалось автоматически вытащить с ресурса официальной документации.
  • Есть даже константы. Но хелпы есть только у тех, что можно найти на вышеприведенном ресурсе официальной документации.
  • События модулей. Синтетические классы с набором методов, т.е. контейнер с возможными событиями определенного модуля, все также с документациями.

Документации с примерами использования и ссылками на ресурс официальной документации. Константы и события находятся в соответствующих модулях в файлах bx_events.php и bx_constants.php (Например /modules/main/bx_events.php и /modules/main/bx_constants.php). Соответственно константы, употребленные в файлах bx_constants.php, в местах иx реального употребления закомментированы.

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

Добавляем в индексацию любимого IDE или в Composer и все. Счастье!

Composer

composer require matiaspub/bx-api-docs --dev

Composer скачает все доки в папку vendor, IDE проиндексирует изменения. Вам останется наслаждаться результатом.

Eclipse

Обязательно PDT (либо аналог). В окне PHP Explorer правой кнопкой по проекту, пункт выпадающего меню Configure -> Add PHP Support. Снова правой кнопкой по проекту, пункт меню Include Path -> Configure Include Path. В окне либо добавляем во вкладке Libraries добавляем папку modules (кнопка Add External Source Folder), либо во вкладке Projects добавляем проект modules (кнопка Add). Предварительно нужно создать проект на основе папки modules и добавить ему поддержку PHP (Configure -> Add PHP Support из первого метода). Используя второй метод, Вы сможете редактировать файлы проекта modules, когда, воспользовавшись первым методом, файлы-подсказки modules будут read-only.

PhpStorm

В настройках PHP IDE PhpStorm (File -> Settings -> Default Settings -> PHP или File -> Settings -> Languages & Frameworks -> PHP ) области Include Path нажав на "+" добавляем путь к папке modules.

Примечание: в первом случае добавляется папка modules для всех новых проектов, во втором - для текущего проекта.

Брюки превращаются. Брюююки прррревращаются.....

Основные синглтоны $APPLICATION, $DB, $USER, $USER_FIELD_MANAGER с подсказками

Синглтоны: $APPLICATION

Максимально полные доки по методам и классам

Доки по методам и классам

Посмотреть события модуля и почитать как его использовать можно так

События модуля с доками

Константы с доками

Константы с доками

Да, согласен

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

Обновления

Обновления происходят только по мажорным версиям главного модуля.

Контакты

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.