people_sdk/module_item

Module People SDK: item components

v1.0.0 2024-03-04 20:14 UTC

Requires

• php: ~7 || ~8
• liberty_code/cache: ^1.0.
• liberty_code/config: ^1.0.
• liberty_code/di: ^1.0.
• liberty_code/framework: ^1.0.
• liberty_code/library: ^1.0.
• liberty_code/register: ^1.0.
• people_sdk/app_profile: ^1.0.
• people_sdk/group: ^1.0.
• people_sdk/item: ^1.0.
• people_sdk/library: ^1.0.
• people_sdk/user_profile: ^1.0.

BSD-3-Clause

README

Description

Library contains application modules, to implements item components, to use API item features, on application. Application is considered as LibertyCode application.

Requirement

• Script language: PHP: version 7 || 8

Framework module installation requirement

1. Module repository: liberty_code_module/validation: version 1.0

   • Module validation (or equivalent).
   • Module rule (or equivalent).

2. Module repository: liberty_code_module/datetime: version 1.0

   • Module datetime (or equivalent).

3. Module repository: liberty_code_module/handle_model: version 1.0

   • Module attribute (or equivalent).

4. Module repository: people_sdk/module_library: version 1.0

   • Module requisition (or equivalent).

5. Module repository: people_sdk/module_attribute: version 1.0

   • Module type (or equivalent).

6. Module repository: people_sdk/module_user_profile: version 1.0

   • Module user (or equivalent).

7. Module repository: people_sdk/module_app_profile: version 1.0

   • Module app (or equivalent).

8. Module repository: people_sdk/module_group: version 1.0

   • Module group (or equivalent).

9. Other module implementation:

   • DI configuration:

     • people_requisition_persistor:

       See people_sdk/item v1.0 framework library implementation requirement, for persistor.

Installation

Several ways are possible:

Composer

1. Requirement

   It requires composer installation. For more information: https://getcomposer.org

2. Command: Move in project root directory

    cd "<project_root_dir_path>"
   

3. Command: Installation

    php composer.phar require people_sdk/module_item ["<version>"]
   

4. Note

   • Include vendor

     If project uses composer, vendor must be included:

       require_once('<project_root_dir_path>/vendor/autoload.php');
     

   • Configuration

     Installation command allows to add, on composer file "

       {
           "require": {
               "people_sdk/module_item": "<version>"
           }
       }
     

Include

1. Download

   • Download following repository.
   • Put it on repository root directory.

2. Include source

    require_once('<repository_root_dir_path>/include/Include.php');
   

Application installation

Configuration

1. Configuration: application module: "

   Add in list part, required modules:

   Example for YML configuration format, from composer installation:

    list: [
        {
            path: "/vendor/people_sdk/module_item/src/schema",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/schema_attribute",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/schema_relation",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/category",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/area",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/area_attribute_scope",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/area_relation_scope",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/area_category_scope",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/area_member",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/area_group_member",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/item",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/item_relation",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/item_category",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        },
        {
            path: "/vendor/people_sdk/module_item/src/cache",
            config_parser: {
                type: "string_table_php",
                source_format_get_regexp: "#^\\<\\?php\\s*(.*)(\\s\\?\\>)?\\s*$#ms",
                source_format_set_pattern: "<?php \\n%1$s",
                cache_parser_require: true,
                cache_file_parser_require: true
            }
        }
    ]
   

Configuration

Application parameters configuration

• Use following file on your modules to configure specific elements

    <module_root_path>/config/ParamApp.php
  

• Elements configurables

  • Configuration to param schema factory.

  • Configuration to param schema attribute factory.

  • Configuration to param schema attribute provider.

  • Configuration to param schema relation factory.

  • Configuration to param category factory.

  • Configuration to param area factory.

  • Configuration to param area attribute scope factory.

  • Configuration to param area relation scope factory.

  • Configuration to param area category scope factory.

  • Configuration to param area member factory.

  • Configuration to param area group member factory.

  • Configuration to param item factory.

  • Configuration to param item relation factory.

  • Configuration to param item category factory.

  • Configuration to param item cache.

Usage

TODO