Scroll to navigation

Lemonldap::NG::Manager::Build(3pm) User Contributed Perl Documentation Lemonldap::NG::Manager::Build(3pm)

NAME

Lemonldap::NG::Manager::Build - Static files generator of Lemonldap::NG Web-SSO system.

SYNOPSIS

  use Lemonldap::NG::Manager::Build;
  
  Lemonldap::NG::Manager::Build->run(
    structFile            => "site/htdocs/static/struct.json",
    confTreeFile          => "site/htdocs/static/js/conftree.js",
    managerConstantsFile  => "lib/Lemonldap/NG/Common/Conf/ReConstants.pm",
    managerAttributesFile => 'lib/Lemonldap/NG/Manager/Attributes.pm',
    defaultValuesFile     => "lib/Lemonldap/NG/Common/Conf/DefaultValues.pm",
    firstLmConfFile       => "_example/conf/lmConf-1.json",
    reverseTreeFile       => "site/htdocs/static/reverseTree.json",
  );

DESCRIPTION

Lemonldap::NG::Manager::Build is only used to build javascript files and Lemonldap::NG constants Perl files. It must be launched after each change.

DEVELOPER CORNER

To add a new parameter, you have to:

See below for details.

Files generated

`scripts/jsongenerator.pl` file uses Lemonldap::NG::Manager::Build::Attributes, Lemonldap::NG::Manager::Build::Tree and Lemonldap::NG::Manager::Build::CTrees to generate

`site/htdocs/static/struct.json`:
Main file containing the tree view;
`site/htdocs/static/js/conftree.js`:
generates Virtualhosts, SAML and OpenID-Connect partners sub-trees;
`site/htdocs/static/reverseTree.json`:
map used by manager diff to find attribute position in the tree;
`Lemonldap::NG::Manager::Constants`:
constants used by all Perl manager components;
`Lemonldap::NG::Common::Conf::DefaultValues`:
constants used to read configuration;
`Lemonldap::NG::Manager::Attributes`:
parameters attributes used by the manager during configuration upload;
first configuration in file format;

Attribute declaration

set your new attribute as a key of attributes() function that points to a hash ref containing:

content type must be declared in sub types() in the same file (except if attribute embeds its own tests) and must match to a form stored in static/forms/ directory;
Relative HTML path to help page (relative to /doc/pages/documentation/<version>/);
default value to set if not defined;
required only if type is `select`. In this case, it must contain an array of { k => <keyName>, v => <display name> } hashref
some words for other developers
if test is not defined for this type or if test must be more restrictive, set here a regular expression or a subroutine. Arguments passed to subroutine are (keyValue, newConf, currentKey). It returns 2 arguments: a boolean result and a message (if non empty message will be displayed as warning or error depending of result);
for regexp based tests, message to display in case of error. Words to translate have to be written as so: __toTranslate__;
for keys/values attributes, test to be applied on key;
for regexp based key tests, same as msgFail for keys test;

If you want to declare a new type, you have to declare following properties:

Tree location

The tree is now very simple: it contains nodes and leaves. Leaves are designed only by their attribute name. All description must be done in the file described above. Nodes are array member designed as this:

  {
    title => 'titleToTranslate',
    help  => 'helpUrl',
    form  => 'relativeUrl',
    nodes => [
      ... nodes or leaf ...
    ]
  }

Explanations:

it must contain an entry of static/languages/lang.json
as above, the relative HTML path to the help page (relative to /doc/pages/documentation/<version>/);
the name of a static/forms/<name>.html file
array of sub nodes and leaf attached to this node
must never be used in conjunction with nodes. Array of leaves only to be displayed in the same form
array of sub nodes that will be displayed with a filter. Not yet documented here, see the source code of site/htdocs/static/js/filterFunctions.js.
filter entry in site/htdocs/static/js/filterFunctions.js for the same feature.

SEE ALSO

<http://lemonldap-ng.org/>

AUTHORS

http://lemonldap-ng.org/team>

BUG REPORT

Use OW2 system to report bug or ask for features: <https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/issues>

Note that if you want to post a ticket for a conf upload problem, please see Lemonldap::NG::Manager::Conf::Parser before.

DOWNLOAD

Lemonldap::NG is available at <https://lemonldap-ng.org/download>

COPYRIGHT AND LICENSE

See COPYING file for details.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

2023-05-12 perl v5.36.0