#### Basics New modules (addons) are extensions points to add extra functionality to Pheix. Technically speaking addons should be just Raku modules. Addon generic requirements: 1. Installation as Raku module via `zef`; 1. Configuration in `config.json` file; 1. Each addon should provide `Pheix::Addons::ModuleName` and `Pheix::Addons::ModuleName::API`. #### Breaking changes ##### Add `$addon` optional argument to `fill_seodata()` method: ```perl method fill_seodata(Str :$pg_addon, Str $pg_type) { ... given $pg_type { when 'debug' { ; } when '404' { %h.append({m => 'Pheix' !!, t => '404'}); } default { %h.append( { m => ($pg_addon eq q{}) ?? 'Pheix' !! $pg_addon, t => $pg_type } ); } } ... } ``` ##### Update `show_pg` method for `Phiex::View::Pages`: 1. Add `$pg_addon` optional argument `fill_seodata()` method: ```perl method show_pg( Str :$pg_addon, Str :$pg_type!, Str :$pg_route!, Str :$pg_content, :%pg_env ) returns Str { ... } ``` 2. Call `fill_seodata()` method with `$pg_addon` argument: ```perl self.fill_seodata(:pg_addon($pg_addon // 'Pheix'), :pg_type($pg_type)); ``` ##### Update given block at `show_pg()` method in `Phiex::View::Pages`: * Make current `default` block as `when 'debug' { ... }`; * Make `when 'index' { ... }` block as `default { ... }`; * Update `debug` calls to `show_pg` method (`grep -rwn "show_pg"`): - lib/Pheix/Controller/Basic.rakumod:[76](https://gitlab.com/pheix-pool/core-perl6/-/blob/3a242f8fcfa58c2ebcc9b67cafb3735440d66d24/lib/Pheix/Controller/Basic.rakumod#L76); - lib/Pheix/Controller/Basic.rakumod:[94](https://gitlab.com/pheix-pool/core-perl6/-/blob/3a242f8fcfa58c2ebcc9b67cafb3735440d66d24/lib/Pheix/Controller/Basic.rakumod#L94); - lib/Pheix/Controller/Basic.rakumod:[114](https://gitlab.com/pheix-pool/core-perl6/-/blob/3a242f8fcfa58c2ebcc9b67cafb3735440d66d24/lib/Pheix/Controller/Basic.rakumod#L114); - t/18-pages.t:[74](https://gitlab.com/pheix-pool/core-perl6/-/blob/3a242f8fcfa58c2ebcc9b67cafb3735440d66d24/t/18-pages.t#L74); - t/18-pages.t:[97](https://gitlab.com/pheix-pool/core-perl6/-/blob/3a242f8fcfa58c2ebcc9b67cafb3735440d66d24/t/18-pages.t#L97). ##### Update `Phiex::Model::JSON`: Add `:conf()` arg to group getters: ```perl method get_setting(Str $addon, Str $setting, Str $key, Bool $nocache?, Str :$conf) returns Cool { ... }; method get_group_setting(Str $addon, Str $group, Str $setting, Str $key, Str :$conf) returns Cool { ... }; method get_all_settings_for_group_member(Str $addon, Str $group, Str $setting, Str :$conf) returns Hash { ... }; ``` #### Module structure Each addon should has: 1. `sharedobj` attr (type `Hash`) as a container for [sharedobj](https://gitlab.com/pheix-pool/core-perl6/-/blob/develop/lib/Pheix/Controller/Basic.rakumod#L23) from `Pheix::Controller::Basic`; 2. `name` attr (type `Str`): ```perl has $.name = 'Weblog'; ``` 3. `jsonobj` attr (type `Pheix::Model::JSON`) with module readonly configuration; ```perl has $.jsonob = Pheix::Model::JSON.new(:addonpath('conf/addons')).set_entire_config(:addon($!name)); ``` 4. `genesis` attr (type `Hash`) with module readonly configuration: ```perl has %.genesis = version => 0.0.1, routes => $!jsonob.get_all_settings_for_group_member($!name, 'routing', 'routes') ; ``` 5. Handler methods ([see routes config](https://gitlab.com/pheix-pool/core-perl6/-/issues/106#note_456241416)) for API rendering. 6. Method for SEO tag import to configuration at initialization stage #### Sample https://gitlab.com/pheix-pool/core-perl6/-/blob/2a32436706e15b102e787f6cbad1be6ad0775234/lib/Pheix/Addons/Embedded/User.rakumod #### Private database, SEO tags > Do we need `conf/system/module.tnk`? More details: https://gitlab.com/pheix-pool/core-perl6/-/issues/106#note_459550707