README

该库的目标是通过在一个地方抽象常用功能，简化 Joomla 扩展开发过程。

用法

将以下行添加到您的代码中

require_once JPATH_LIBRARIES . '/compojoom/include.php';

从 GitHub 构建此包的需求

为了构建此库的安装包，您需要以下工具

• 命令行环境。Linux / Mac OS X 下的 Bash。在 Windows 上，您需要使用具有提升权限（管理员）的命令提示符运行大多数工具。

• 路径中的 PHP CLI 二进制文件

• Git 二进制文件(*)

• 已安装的 composer

构建说明

composer install

cp jorobo.dist.ini jorobo.ini

robo build

这将创建一个位于 /dist 文件夹中的可安装包，您可以将其与您的扩展一起部署。

使用头像和配置文件支持

在您的组件配置中，您可以创建以下字段

<fieldset name="integrations" label="Integrations"
	          addfieldpath="/libraries/compojoom/form/fields">
  <field name="support_avatars" type="avatars"
         default="0"
         isPro="@@PRO@@"
         label="LIB_COMPOJOOM_SUPPORT_AVATARS_LABEL" description="LIB_COMPOJOOM_SUPPORT_AVATARS_DESC" />
  <field name="profile_link" label="LIB_COMPOJOOM_SUPPORT_PROFILES_LABEL"
         description="LIB_COMPOJOOM_SUPPORT_PROFILES_DESC"
         isPro="@@PRO@@"
         type="profiles" default="" />
</fieldset>

注意：字段集有一个 addfieldpath -> 这将从该位置获取字段。isPRO 属性确定是否应将所有可用选项都提供给选择。通常在核心扩展中，我们不希望提供这些字段。

现在，要实际在 PHP 文件中使用此系统，您需要进行以下操作

$avatarSystem = CompojoomAvatars::getInstance($system);
$avatars = $avatarSystem->getAvatars($users);

$system 是头像系统名称。通常是从：配置中的 support_avatars 获取的值。
$users 是一个包含用户 ID 的数组

要在 PHP 文件中使用配置文件系统，您需要进行以下操作

$profileSystem = CompojoomProfiles::getInstance($profile);
$link = $profileSystem->getLink($id);

$profile 是配置文件系统名称。通常是从配置中的 profile_link 获取的值
$id 是为我们生成链接的用户 ID

版权声明和免责声明

Compojoom 库 - 版权 (c) 2008 - 2016 Compojoom.com

本程序是自由软件：您可以重新分配它并/或修改它，具体请参阅由自由软件基金会发布的 GNU 通用公共许可证的条款，许可证版本为 3 或（根据您的选择）更高版本。

本程序以希望其有用的方式分发，但没有任何保证；甚至没有关于其适销性或针对特定目的的适用性的暗示保证。有关详细信息，请参阅 GNU 通用公共许可证。

您应已收到一份 GNU 通用公共许可证副本。如果没有，请参阅 https://gnu.ac.cn/licenses/。