astridx/jorobo

基于Robo.li的Joomla扩展开发和发布工具和任务

维护者

详细信息

github.com/astridx/jorobo

源代码

0.8.2 2020-03-31 10:36 UTC

README

Latest Stable Version Total Downloads Latest Unstable Version License

警告:目前处于alpha阶段!

基于Robo.li的Joomla扩展开发和发布工具和任务

安装(独立安装)

  • composer install
  • 配置jorobo.ini
  • vendor/bin/robo

功能概述

  • vendor/bin/robo build - 将您的扩展构建为可安装的Joomla!包或zip文件,包括替换项
  • vendor/bin/robo map - 将您的扩展映射(符号链接)到运行的Joomla!安装中
  • vendor/bin/robo headers - 在源目录中添加/更新版权头信息(在jorobo.ini中设置它们)
  • vendor/bin/robo bump - 将源目录中每个文件中的字符串__DEPLOY_VERSION__替换为jorobo.ini中设置的版本号。

如何在您的扩展中使用

执行composer require joomla-projects/jorobo:dev

确保您的RoboFile.php加载了任务

<?php
require 'vendor/autoload.php';

class RoboFile extends \Robo\Tasks
{
	use \Joomla\Jorobo\Tasks\loadTasks;
	..

然后您可以使用它来执行自己的任务,例如

$this->taskMap($target)->run();

或者

$this->taskBuild($params)->run()

查看库根目录中的RoboFile.php以获取示例文件。

在您的扩展中使用

目录设置

为了使用JoRobo,您应该使用以下目录结构(类似于“常见”的Joomla结构)

组件

source/administrator/components/com_name/
source/administrator/components/com_name/name.xml
source/administrator/components/com_name/script.php (Optional)
source/components/com_name/
source/administrator/language/en-GB/en-GB.com_name.ini
source/administrator/language/en-GB/en-GB.com_name.sys.ini
source/language/en-GB/en-GB.com_name.ini
source/media/com_name

模块

source/modules/mod_something
source/media/mod_something
source/language/en-GB/en-GB.mod_something.ini

插件

source/plugins/type/name
source/media/plg_type_name
source/administrator/language/en-GB/en-GB.plg_type_name.ini

扩展设置

可以使用示例RoboFile,也可以在此基础上扩展。