Oxyzen Almanac Block

?? Oxyzen Almanac Block ????? ??? ????????, ?????????? ??? ?????? ????????????????? block ??? ????????? ???????? ???????? "??? ??????". ??????????? ???????? layouts, themes, ???????????? ???????????, responsive ???????? ??? ??????????? ?????????? ?? ?? BootLib UI Framework.

??????????????

• 3 Layouts - `card` - ?????? ????? - `vcard` - ????????? ????? (?????? ????????, ??????? ?????) - `list` - ????? ????????? ?? modal
• Themes ?? ????? CSS `light-dark()`
• ?????????? ??????? (thumb/full)
• ???????????? ??????? ?? ISO codes (`en`, `el`, `fr`, `zh-cn`, `zh-tw`, ?.??.)
• BootLib modal integration (???????????)
• JSON-based data ??? ????? ??? ????
• ?????? responsive
• Config-driven ??????????? ???? `conf.php`
• ??????? ?? Ascoos OS (???????????)

???? ???????

/config
    conf.php
/data
    /4
        /20
            almanac.json
        /21
            almanac.json
        ...
/langs
    en.php
    el.php
    fr.php
    zh-cn.php
    zh-tw.php
/libs
    card.php
    vcard.php
    list.php
/themes
    /default
        theme.css
index.php
README.md

????????? (config/conf.php)

return [
    'aos'        => false,     // Ascoos OS integration
    'lang'       => 'en',      // Default language
    'layout'     => 'card',    // card, vcard, list
    'theme'      => 'default', // theme folder
    'image'      => true,      // show images
    'img_path'   => 'images/blocks/almanac',
    'title'      => true,
    'date'       => true,
    'count'      => 5,         // for list layout
    'bootlib'    => false,     // enable BootLib UI
    'box_class'  => 'box',     // BootLib container class
    'title_class'=> 'title'    // BootLib title class
];

?????

?? block ?????????? ???? ??? index.php:

<section class="oxyzen-block">
    <div class="oxyzen-block-almanac <?= $layout ?>">
        <?php include "libs/{$layout}.php"; ?>
    </div>
</section>

???????? layout ???? ??? ?? conf.php.

Layouts

card

vcard

list

???????????? ???????

???? ?????? ??????? ????? ????:

<?php
return [
    'on-this-day' => 'On this day'
];

?????????????? ??????? ISO ???????:

• `zh-cn` (Simplified Chinese)
• `zh-tw` (Traditional Chinese)
• `pt-br`
• `en-gb` ? fallback ?? `en`

?? ??????? ????? ???????? fallback ?? en ?? ?????? ??????.

???????? ???????????

???? ????? ???? ?? ???? ??? JSON:

/data/4/21/almanac.json

?????:

{
  "04-21": [
    {
      "date": "1967-04-21",
      "image": "1967-greece-military-coup.webp",
      "event": {
        "el": "??????? ??? ????????...",
        "en": "Text in English..."
      }
    }
  ]
}

Themes

?? themes ?????????? ???:

/themes/{theme}/theme.css

????????????? CSS light-dark():

:root {
    --al-bg: light-dark(#ffffff, #111111);
    --al-fg: light-dark(#111111, #f5f5f5);
}

BootLib Modal Integration

?? bootlib = true, ????:

• ?????????? ???????? ?? BootLib CSS/JS
• ?? modal ???????:

<a data-blib-modal="modal-1">Open</a>

<div id="modal-1" class="blib-modal">
    <div class="blib-modal-content">
        ...
    </div>
</div>

??? ?????????? custom JavaScript.

Responsive Layouts

• `card` ? 100% width ?? mobile
• `vcard` ? ??????? ?????? ?? ?????? ??????
• `list` ? ????????? thumbs & compact rows

??? ?? responsive rules ?????????? ??? theme.

??????????? ??????????

• Auto?generator ??? ???? ??? ?????? ??? ?????
• Admin panel ??? ???????? ?????????
• API endpoint ??? ????????? ?????
• Dark/Light theme switching

?????

AGL-F License - Ascoos Genereal License (Free).

??????????

Pull requests ????? ???????????. ??? ??????? ???????, ?????? ????? ??? issue.

??????????

????????? ???????

?????????? ??? ASCOOS OS

https://www.ascoos.com