Maksoft Максофт - интернет решения за бизнеса

Имате въпроси?попитайте ни и ще ви отговорим

Събития, презентации, обучения организирани от Максофт. Изложения с участието на Максофт.

Хронология на събитията свързани с интернет решения, графичен дизайн и развитие на бизнеса.
...
Събития
Начало / За нас / Актуално...

Feed API предоставя JSON достъп до съдържанието на Maksoft CMS за външни приложения, сайтове и интеграции. Позволява четене на данни от таблици, филтриране, сортиране и ограничаване на достъпа според нивото на потребителя.

Основен формат

https://maksoft.net/feed/{table_name}?{параметри}
или
https://maksoft.net/feed/{site_id}/{table_name}?{параметри}

Общи параметри

Параметър	Тип / Формат	Описание	Пример
limit	integer	Максимален брой записи (по подразбиране 50, максимум 10000)	limit=100
offset	integer	Брой записи за прескачане (пагинация)	offset=200
debug	0 / 1	Активира debug режим и показва SQL заявката	debug=1
order_by	string	Поле, по което се сортира резултатът	order_by=date_modified
order_dir	ASC / DESC	Посока на сортиране	order_dir=DESC
site_id	integer	Идентификатор на сайта (ако не е зададен в URL)	site_id=2

Филтриране на резултатите (WHERE)

API-то поддържа динамично филтриране на резултатите чрез URL параметри. Всички филтри се интерпретират като SQL WHERE условия.

Оператор	Описание	Пример
=	Точно съвпадение	status=1
>	По-голямо от	preview>100
<	По-малко от	id<500
>=	По-голямо или равно	preview>=1000
<=	По-малко или равно	views<=5000
!= / <>	Различно от	status!=0
~	Текстово съвпадение (LIKE %value%)	title~Новини

Операторите могат да бъдат част от името на параметъра (preview>100) или да са URL-кодирани (preview%3E100).

Сортиране

?order_by=date_modified&order_dir=DESC

Може да бъде дефинирано и в mapping конфигурацията:

{
  "order": {
    "field": "sort_n",
    "direction": "ASC"
  }
}

Изчисляеми полета (Computed Fields)

"computed": {
  "url": "feed_pageurl(n)",
  "lastmod": "feed_date('Y-m-d', date_modified)"
}

Тези функции се дефинират във feed.safe.func.php и се прилагат автоматично при извеждането на данните.

Изключване на полета

"fields_to_exclude": ["PageURL", "phpvars"]

Позволява изключване на определени колони от резултата.

Контрол на достъпа

"access_filter": "pages.SecLevel <= {ACCESS_LEVEL}"

Ограничава достъпа според нивото на потребителя ($o_page->_user['AccessLevel']).

Примери

/feed/pages
/feed/pages?status=1
/feed/pages?preview>100
/feed/pages?title~услуги
/feed/pages?order_by=date_modified&order_dir=DESC
/feed/pages?debug=1

Примерен JSON отговор

{
  "meta": {
    "table": "pages",
    "site_id": 2,
    "limit": 50,
    "offset": 0,
    "count": 2,
    "access_level": 0,
    "result": "ok",
    "debug_sql": "SELECT * FROM `pages` WHERE `SiteID`=2 ..."
  },
  "data": [
    {
      "n": "2",
      "name": "Начало",
      "url": "https://www.maksoft.bg/",
      "lastmod": "2025-07-26"
    }
  ]
}

...

feed api слой за екпорт
Начало / Услуги / Поддръжка на сайт / Документация...

Инсталацията под Windows на Maksoft CMS изисква инсталация на Laragon или XAMPP (за Apache и MySQL), сваляне на PHP файловете от github.com/maksoftnet/ms, импорт на база данни maksoft.sql, инсталиране на зависимостите с composer.

Основно процесът преминава през
- инсталация на локален apache сървър Xampp или Laragon
- git clone https://github.com/maksoftnet/ms
- composer инсталация на зависимостите в директории
  /ms composer install
  /modules composer install
- инсталация на mysql, създаване на база maksoft, импорт на база данни
  mysql -u root maksoft < maksoft.sql
- създаване на потребител maksoft с парола XXX за работа с базата и задаване на права All Privileges
- настройка на някои инициализиращи променливи
my.ini

[mysqld]

max_allowed_packet = 2048M

tmp_table_size=256M

max_heap_table_size=256M

net_read_timeout = 600

net_write_timeout = 600

innodb_buffer_pool_size=512M

php.ini

memory_limit = 512M

max_execution_time = 300

post_max_size = 512M

upload_max_filesize = 512M

...
Инсталация на maksoft cms
Начало / Услуги / Поддръжка на сайт / Документация...

Версия 4.0 превръща Maksoft CMS от мултисайт система за управление на интернет сайтове в глобална мрежа за управление и разпространение на информация в интернет между различни платформи.

MBT (Model - Business - Transport) архитектура.

Платформата се изгражда на Node.Js + Type Script.

Това е централната система, която приема, обработва, архивира и дистрибутира данни между:

локални CMS (Maksoft CMS 1.0 до 3.0, WordPress, PrestaShop)
складов софтуер и доставчици
социални мрежи
външни API-та
платежни услуги
мобилни приложения

Тя предоставя REST API, Webhooks, cron задачи и съхранява данните едновременно в свързани релационна PostgreSQL и нерелационна MongoDB бази данни или в S3-совместимо хранилище.

PostgreSQL е структурираното ядро, а MongoDB е динамичното, специфично разширение.

Как работи тази комбинация на практика:

Действие	PostgreSQL	MongoDB
Създаване на нова страница	`pages` таблица	—
Добавяне на WooCommerce еквивалент	връзка `platform_links`	`platformData` документ
Импорт от PrestaShop	`products` таблица	допълнителни атрибути в JSON
Социална активност или log събитие	—	`logs` колекция в MongoDB

Как се изгражда архитектурно?

Всички базови данни са в PostgreSQL (включително page_id)
MongoDB пази „разширения“ по page_id (или external_ref)
Business слоят решава кога да ползва едното или другото
REST/GraphQL API-то ги агрегира при нужда

...

maksoft cms 4.0
Начало / Услуги / Поддръжка на сайт / Документация...

За импорт на даннните е нужно да разрешите на MySQL в my.ini импорт на големи пакети, да създадем БД maksoft като команда за импорт mysql -u root maksoft < maksoft.sql и да дадем права на потребител maksoft за достъп от скрипт.

Създайте база данни (БД) maksoft.
Създайте потребител maksoft с достъп до БД maksoft

Задайте избраната парола за достъп в конфигурационния файл lib/config.php

...

public $db_user_upl = 'maksoft';

public $db_pass_upl = 'Избраната парола';

...

След това може да импортирате (seed) реална база или само структурата.

АК импортиране база и данни, базата данни ще бъде голяма и препоръката е maksoft.sql да се инсталира чрез команден ред. Предварително в

MySQL конфигурация

C:/xampp/mysql/bin/my.ini

трябва да разрешим големи пакети

[mysqld]

max_allowed_packet = 2048M

tmp_table_size=256M

max_heap_table_size=256M

След това от CommandShell (cmd) стартиран като Administrator отидете в папка
cd c:/xampp/mysql/bin/mysql
изпълнете:

mysql -u root maksoft < maksoft.sql

Изчакайте. Процесът може да отнеме време повече от 10 минути.

Прогреса можете да следите в phpMyAdmin

...
mysql конфигурация и импорт на данни
Начало / Услуги / Поддръжка на сайт / Документация / Инсталация на Maksoft CMS...
Инсталация на PHP платформата
git clone https://github.com/maksoftnet/ms

Изпълнете клонирането от работната папка на Xampp c:/xampp/htdocs.

След края на клонирането ще имате папка c:/xampp/htdocs с Maksoft CMS.

...
Инсталация на maksoft cms от github
Начало / Услуги / Поддръжка на сайт / Документация / Инсталация на Maksoft CMS...
Бързината на сайта вече е ключов фактор за SEO оптимизация. С новия сървърен кеш в Maksoft CMS, страниците се зареждат до 5 пъти по-бързо и поемат 20+ пъти повече трафик. Това повишава рейтинга в Google и подобрява потребителското изживяване – особено при кампании и пикова посещаемост.

Ново ниво в SEO чрез кеширане

Новата функционалност кешира всяка често посещавана страница за период от 5 минути. Това позволява на следващите потребители да я заредят почти мигновено, без допълнително натоварване върху сървъра. Резултатът: по-бърз сайт, по-добри позиции и по-висока SEO ефективност.

Какво подобрява кеширането?
- По-високи позиции в Google благодарение на ускорено време за зареждане.
- Нисък bounce rate – посетителите остават по-дълго на сайта.
- Поддържане на трафик в пикови моменти, включително кампании и новини.
- Оптимизация на ресурси без компромис със съдържанието.
Съвместно действие с MemCache и CDN

Сървърният кеш се комбинира с MemCache, който управлява динамичните компоненти на сайта, и клауд CDN кеширане, което осигурява светкавична скорост за глобалните потребители. Това дава предимство пред конкуренцията при SEO оптимизация на сайтове с голям трафик.

Как да видите ефекта?

Излезте от административен режим и отворете често посещавана страница – ще забележите моментално по-бързо зареждане. В административен режим кеширането е изключено, за да работите винаги с най-актуалното съдържание.

Какво предстои?

Целта е постигане на над 99.99% uptime при всякакво натоварване. Това е решаващ компонент от цялостната SEO оптимизация стратегия, особено при активно развиващи се сайтове с голямо съдържание и рекламна активност.

Какво да направите за максимален ефект?

Поискайте оферта за Външна Google SEO оптимизация на интернет сайт с Фейсбук Трафик Фуния!

Това ще допълни вътрешната сайт оптимизация на Вашия сайт с органичен линк билдинг- връзки създадени към Вашия сайт от други сайтове и социални мрежи. Нещо повече- това ще сподели актуалната информация от Вашия сайт в социални мрежи- Фейсбук, което привлича нови клиенти и има косвен ефект за Вашите позиции в Гугъл.

Повече информация, инструмент за планиране на ключови думи и цени има ТУК.
...
5х по-бърз сайт за seo с нов кеш от maksoft cms
Начало / Услуги / Поддръжка на сайт / Помощна информация / Актуализации...
Laragon или Xampp са наличните сървъри, които ще ви създадат локална работна среда под Windows или iOS.

Инсталирайте Laragon от Laragon.org

Инсталирайте XAMPP от- www.apachefriends.org/

Инсталация на XAMPP включва работна среда apache2 и MySQL нужна за работа с Maksoft CMS.

Стандартно се инсталира на c:/xampp като при наличие на стара версия следва да преименувате старата папка, защото ще я създаде отново.
...
xampp или laragon Инсталация с apache и mysql
Начало / Услуги / Поддръжка на сайт / Документация / Инсталация на Maksoft CMS...
Нужни са 2 метода, за да вмъкнете CSS, JS, HTML или PHP логика без да променяте ядрото. Hook системата в Maksoft CMS използва $o_page обекта и централен execution layer, който обединява legacy и modern архитектурата в един pipeline.

Как работи Hook системата

$o_page->add_hook() регистрира callback функция към конкретна hook точка. $o_page->hook() изпълнява всички регистрирани функции по ред. ThemeRuntime зарежда legacy данните и регистрира default hook-ове. Системата използва един page object и един asset registry.

Автоматично налични hook-ове
- main_content – рендерира page content
- pageurl – включва legacy PageURL
- css – управлява CSS assets
- js – управлява JS assets
- html_before и html_after – съдържание около <main>
ThemeRuntime като bridge слой

ThemeRuntime::boot() инициализира hook средата. Той регистрира main_content и pageurl. Темата не включва PageURL директно. Разработчикът работи само с $o_page->hook() и $o_page->render_assets(). Това означава, че темата остава presentation слой. Не се пипа ядро, не се дублира pipeline, не се създават втори execution механизми.

Интеграция на Block система

BlockResolver чете активните блокове от базата. Системата генерира CSS, HTML и JS чрез същите hook точки. Блоковете използват съществуващия hook execution layer. Грешната архитектура води до конфликт на assets, трудно обновяване и проблеми с поддръжката. Централизираната hook система предотвратява това.
...
Хукове (hooks)
Начало / Услуги / Поддръжка на сайт / Документация...
Максофт е основа на headless CMS система и целта на новия рендерер на теми е да осигури лесна адаптация и визуализация на сайтове създадени както за legacy Maksoft CMS, така и нови дизайни и теми писани за Maksoft CMS, Wordpress, Joomla и др.

Темите работят върху стандартизиран слой от данни (ViewData), предоставен от CMS. Темата не комуникира директно с базата данни или CMS класове.

Създаването на нова тема започва със създаването директория на темата в папка /themes/ms/... и записването на основния index.php файл в нея.

Файлът index.php зарежда engine bootstrap /themes/ms/_bootstrap.php, инициализира ViewData и използва предоставения обект $o_page за достъп до CMS hooks.

Темата се регистрира в CMS чрез запис в таблица Templates. Това я прави достъпна за конкретен сайт (SiteID) или за всички сайтове (SiteID = 0).

CSS/JS активите се управляват централизирано чрез cms_assets.php, което предотвратява дублиране на зависимости и осигурява контрол на версиите.

/themes – Official Theme Architecture Spec (v1.3)

1. Цел на директорията /themes

/themes е стандартният слой за рендериране на CMS.
- теми, групирани по engine (renderer)
- споделени helpers и assets на ниво engine
- теми, които работят със ViewData
/themes НЕ заменя legacy /Templates, а съществува паралелно.

2. Основен принцип

CMS подава ViewData → Theme engine рендерира → Theme определя структурата
- ❌ темите не четат база
- ❌ не инстанцират CMS класове
- ❌ не съдържат бизнес логика
- ✅ рендерират подадени данни
3. Йерархия на директориите
```
/themes
    /ms
    /wp
    /joomla
```
Engine определя:
- формата на ViewData
- helpers
- asset registry
- render conventions
4. Engine-level структура (пример: /themes/ms)
```
/themes/ms

    /base
    /components
    /helpers
    /blocks

    _bootstrap.php
    cms_assets.php
    functions.php
```
_bootstrap.php
- инициализира theme runtime
- зарежда helpers
- зарежда engine functions
пример:
```
require_once __DIR__.'/helpers/block_dom.php';
```
cms_assets.php
- дефинира CSS/JS зависимости за engine-а
- Bootstrap, Tailwind, Alpine и др.
- използва се от всички теми
functions.php
- engine helpers
- hooks
- филтри
- НЕ е theme-specific
/helpers
- shared helper функции
- block_dom.php
- meta_tags.php
- breadcrumbs.php
- pagination.php
/blocks
- default CMS block templates
- fallback ако темата няма собствен template
пример:
```
/themes/ms/blocks

    text.php
    image.php
    subpages.php
```
5. Theme-level структура
```
/themes/ms/base/none

    theme.json
    index.php

    /blocks
        text.php
        image.php
        subpages.php

    /js
        theme.js
        /blocks
            gallery.js
            hero.js

    /css
        theme.css

    header.php
    footer.php
```
Theme index.php е основният render файл.

6. ViewData структура
```
view

 ├ context
 ├ auth
 ├ user
 ├ user_context
 ├ site
 ├ page
 │   └ streams
 │       └ main
 │           └ items[]
 └ theme
```
Blocks се намират в:
```
$page['streams']['main']['items']
```
Всеки блок съдържа:
```
[
    id
    type
    data
    dom
]
```
7. Block Rendering

Block rendering се управлява от BlockResolver.

Theme index.php извиква:
BlockResolver:
- чете $page['streams']['main']['items']
- намира block template
- рендерира HTML
Template resolution:
```
theme/blocks/{pageType}/{block}.php
theme/blocks/{block}.php
themes/ms/blocks/{pageType}/{block}.php
themes/ms/blocks/{block}.php
```
8. DOM Integration (CMS → Theme JS API)

CMS добавя стандартни DOM markers:
```
data-block
data-id
data-editable
```
DOM markers се генерират чрез helper:
```
block_dom($block)
```
пример:
```
<section>
```
резултат:
```
 
```
DOM markers са официалният JS API между CMS и темата.

9. JavaScript Block Lifecycle

Темите инициализират JS блокове чрез DOM markers.
```
document.querySelectorAll("[data-block]").forEach(el => {

    const type = el.dataset.block

    if (Theme.blocks[type]) {
        Theme.blocks[type](el)
    }

})
```
Пример:
```
Theme.blocks.gallery = function(el) {

    console.log("Gallery init", el.dataset.id)

}
```
10. Recommended Theme JS Structure
```
/themes/ms/themeX

    /js
        theme.js
        /blocks
            gallery.js
            hero.js
```
Пример runtime:
```
window.Theme = window.Theme || {}
Theme.blocks = {}
```
11. ContentTools Integration

CMS маркира editable области чрез:
```
data-editable
```
ContentTools се инициализира върху:
```
*[data-editable]
```
12. Theme configuration (theme.json)

theme.json е незадължителен конфигурационен файл. CMS използва overwrite cascade.

Използва се първият намерен theme.json, тръгвайки от директорията на темата нагоре.
```
/themes/ms/base/none/theme.json
/themes/ms/base/theme.json
/themes/ms/theme.json
/themes/theme.json
```
13. Theme Development Checklist
- Създайте директория в /themes/ms/
- Добавете index.php
- Заредете /themes/ms/_bootstrap.php
- Използвайте $o_page->hook('main_content')
- Добавете block templates в /blocks
- Използвайте block_dom($block)
- Инициализирайте JS чрез Theme.blocks
14. Key Principles
- Single page object ($o_page)
- CMS → data layer
- Theme → presentation layer
- Blocks се подават като streams
- Theme контролира layout
- DOM markers са JS integration API
- Page cache кешира крайния HTML
15. Status
- Version: v1.3
- Change: BlockResolver + DOM helper
- Backward compatible: Да
- Runtime cost: минимален
16. Theme Runtime Flow
```
HTTP Request
      ↓
page.php
      ↓
loader.php
      ↓
$o_page->init_page_blocks()
      ↓
PageData
      ↓
ThemeMapper
      ↓
ViewData
      ↓
resolveTheme()
      ↓
include theme/index.php
      ↓
$o_page->hook('main_content')
      ↓
BlockResolver
      ↓
block templates
      ↓
HTML output
      ↓
page cache
```
Theme получава готов ViewData и е отговорна само за визуализацията.

Основният принцип е:

CMS управлява данните → Theme управлява HTML и визуализацията
...
Създаване на теми (темплейти)
Начало / Услуги / Поддръжка на сайт / Документация...

Максофт е дигитална агенция със собствени продукти за изработка, поддръжка, SEO оптимизация и маркетинг на интернет сайтове от 1999 година. Ние сме SEO фирма със собствени продукти и услуги за управление на съдържание, SEO оптимизация, дигитален маркетинг и реклама на фирми от различни браншове.

Максофт има над 25 години опит в печатна и интернет реклама. Компанията е водещ вносител на рекламни материали.

Нашият опит

Управление на онлайн репутация 16 г.

SEO оптимизация 18 г.

Печат 29 г.

Рекламни материали и сувенири 29 г.

Уеб дизайн 27 г.

Маркетинг и Реклама 34 г.

Следвайте ни

Максофт Нет

Имате въпроси?попитайте ни и ще ви отговорим

Основен формат

Общи параметри

Филтриране на резултатите (WHERE)

Сортиране

Изчисляеми полета (Computed Fields)

Изключване на полета

Контрол на достъпа

Примери

Примерен JSON отговор

Как работи тази комбинация на практика:

Как се изгражда архитектурно?

Ново ниво в SEO чрез кеширане

Какво подобрява кеширането?

Съвместно действие с MemCache и CDN

Как да видите ефекта?

Какво предстои?

Какво да направите за максимален ефект?

Как работи Hook системата

Автоматично налични hook-ове

ThemeRuntime като bridge слой

Интеграция на Block система

/themes – Official Theme Architecture Spec (v1.3)

1. Цел на директорията /themes

2. Основен принцип

3. Йерархия на директориите

4. Engine-level структура (пример: /themes/ms)

_bootstrap.php

cms_assets.php

functions.php

/helpers

/blocks

5. Theme-level структура

6. ViewData структура

7. Block Rendering

8. DOM Integration (CMS → Theme JS API)

9. JavaScript Block Lifecycle

10. Recommended Theme JS Structure

11. ContentTools Integration

12. Theme configuration (theme.json)

13. Theme Development Checklist

14. Key Principles

15. Status

16. Theme Runtime Flow

За нас

Изработка сайт

Поддръжка на сайт

SEO

Нашият опит

Следвайте ни

Запитване

Обслужване на клиенти

За нас

Връзки

Контакти

1. Цел на директорията `/themes`

4. Engine-level структура (пример: `/themes/ms`)

12. Theme configuration (`theme.json`)