# Selima Website Content Management System
# ShortCut.pm: The shortcut subroutines.

#  Copyright (c) 2003-2018 imacat.
#
#  Licensed under the Apache License, Version 2.0 (the "License");
#  you may not use this file except in compliance with the License.
#  You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
#  Unless required by applicable law or agreed to in writing, software
#  distributed under the License is distributed on an "AS IS" BASIS,
#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
#  See the License for the specific language governing permissions and
#  limitations under the License.

# Author: imacat <imacat@mail.imacat.idv.tw>
# First written: 2003-03-23

package Selima::ShortCut;
use 5.008;
use strict;
use warnings;
use base qw(Exporter);
use vars qw(@EXPORT @EXPORT_OK);
BEGIN {
@EXPORT = qw(h dh __ C_ F_ N_);
@EXPORT_OK = @EXPORT;
# Prototype declaration
sub h($);
sub dh($);
sub __($@);
sub C_($@);
sub F_($@);
sub N_($@);
}

use Selima::DataVars qw(:l10n);

# Define them first
# h: Escape the HTML characters
sub h($) {
    local ($_, %_);
    $_ = $_[0];
    return "" if !defined $_;
    s/&/&amp;/g;
    s/</&lt;/g;
    s/>/&gt;/g;
    s/"/&quot;/g;   # (xgettext) "
    return $_;
}

# dh: De-escape the HTML characters
sub dh($) {
    local ($_, %_);
    $_ = $_[0];
    return "" if !defined $_;
    s/&quot;/"/g;   # (xgettext) "
    s/&gt;/>/g;
    s/&lt;/</g;
    s/&amp;/&/g;
    return $_;
}

# N_: Null maketext function
sub N_($@) {
    # Watch out for this perl magic! :p
    return $_[0] unless wantarray;
    return @_;
}

# We must load SetL10N after N_().
use Selima::SetL10N;

# __: Maketext/gettext
sub __($@) {
    local ($_, %_);
    my ($key, @params, $pkg);
    ($key, @params) = @_;
    # Initialize the localization framework
    set_l10n if !defined $LH;
    return $LH->maketext($key, @params);
}
# C_: Maketext in the common domain
sub C_($@) {
    local ($_, %_);
    my ($key, @params);
    ($key, @params) = @_;
    # Initialize the localization framework
    set_l10n if !defined $CLH;
    return $CLH->maketext($key, @params);
}
# F_: Maketext, fallback from the current domain to the common domain
sub F_($@) {
    local ($_, %_);
    my ($key, @params, $pkg);
    ($key, @params) = @_;
    # Initialize the localization framework
    Selima::SetL10N::set_l10n if !defined $LH || !defined $CLH;
    # Try the local text
    return $LH->maketext($key, @params)
        if exists ${$LH->{"Lexicon"}}{$key};
    # Try the common text
    return $CLH->maketext($key, @params);
}

return 1;