Рекомендации к версиям плагинов

[Sam Jack]

Совместимость с XenForo
2.0.x
Рекомендации к версиям плагинов


Рекомендуемый формат строковой (string) версии плагина
XenForo использует принцип MAJOR.MINOR.PATCH (например, 2.0.0 для первого стабильного релиза XF2) до нумерации версий, и мы рекомендуем аналогичный подход к версиям ваших собственных плагинов.

• MAJOR - версия при внесении существенных изменений функций, особенно изменений, нарушающих обратную совместимость
• MINOR - когда вы добавляете функциональность предпочтительно с обратной совместимостью
  
• PATCH - когда вы делаете обратно совместимые исправления ошибок

Рекомендуемый формат версии идентификатора (ID) плагина
Идентификаторы версий для плагинов являются целыми числами, которые используются для сравнения внутренней версии. Это позволяет нам более легко обнаружить, когда одна версия старше другой. С каждой версией плагина индетификатор должен увеличиваться по крайней мере на 1, но соглашение, которое мы используем внутри XenForo, потенциально полезно также для плагины. Идентификаторы версий находятся в формате aabbccde.

• aa - представляет основную (Major) версию
  
• bb - представляет второстепенную (Minor) версию
• сс - представляет версию исправлений (Patch)
• d - представляет состояние, например 1 для альфа релизов, 3 для бета релизов, 5 для пререлизов и 7 для стабильных релизов
• e - представляет версию состояния

Например, плагин с версией строки пререлиза (Release Candidate) 1.7.3 будет иметь идентификатор 1070354. Окончательный стабильный релиз XF2 будет иметь идентификатор 2000070. Версия 1.5.0 бета (Beta) 3 XF имела идентификатор 1050033. Стабильная версия 99.99.99 будет иметь ID 99999970 ... и, возможно, вам следует замедлиться.

Это носит рекомендательный характер, не обязательный, но его следует придерживаться так как это логично и при работе с созданием плагинов при вводе ID например 2000070 вам 2.0.0.