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 и т.н.

/themes – Official Theme Architecture Spec (v1)

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

/themes е новият стандартен слой за рендериране в CMS-а.

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

2. Основен принцип
CMS подава ViewData → Theme engine рендерира → Theme решава структурата

Темите:
- ❌ не четат база
- ❌ не инстанцират CMS класове
- ❌ не съдържат бизнес логика
- ✅ рендерират подадени данни
3. Йерархия на директориите
- всяка подпапка е engine / renderer
- engine определя:
  - формата на ViewData
  - helpers
  - assets
  - conventions
/themes

/ms
/wp
/joomla
/tailwin

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

/themes/ms

/base
/components
/helpers

cms_assets.php
functions.php

Описание:

cms_assets.php
- дефинира CSS/JS зависимости за engine-а
- Bootstrap, Tailwind, Alpine, etc.
- използва се от всички теми в engine-а
functions.php
- engine-level helpers
- hooks
- филтри
- НЕ е theme-specific
/helpers
- споделени partial-и:
  - meta_tags.php
  - breadcrumbs.php
  - pagination.php
/components
- reusable view components:
  - header.php
  - navigation.php
  - subpages.php
  - footer.php
5. Theme-level структура (пример: /themes/ms/base/none)

/themes/ms/base/none

theme.json
index.php

header.php (optional)
footer.php (optional)
subpages.php (optional)

6. Theme configuration (theme.json) – overwrite resolution

6.1 Статус на theme.json
- theme.json е НЕзадължителен
- темата може да работи без собствен theme.json
- конфигурацията се определя чрез overwrite cascade
6.2 Правило за overwrite (основно правило)

Използва се първият намерен theme.json, тръгвайки от директорията на темата нагоре.
НЯМА merge между конфигурации.
- няма наследяване по ключове
- няма сливане на масиви
- няма частични override-и
➡️ Един файл = един източник на истина

6. Theme configuration (theme.json) – overwrite resolution

6.1 Статус на theme.json
- theme.json е НЕзадължителен
- темата може да работи без собствен theme.json
- конфигурацията се определя чрез overwrite cascade
6.2 Правило за overwrite (основно правило)

Използва се първият намерен theme.json, тръгвайки от директорията на темата нагоре.
НЯМА merge между конфигурации.
- няма наследяване по ключове
- няма сливане на масиви
- няма частични override-и
➡️ Един файл = един източник на истина

6.3 Алгоритъм за търсене на theme.json

При theme path:

/themes/ms/base/none

CMS търси theme.json в следния ред:
1. /themes/ms/base/none/theme.json
2. /themes/ms/base/theme.json
3. /themes/ms/theme.json
4. /themes/theme.json (по избор, global fallback)
Търсенето СПИРА:
- при първия намерен theme.json
- или при достигане на /themes
- или при достигане на filesystem root /
➡️ Никога не се преминава над /themes, за да няма зацикляне или неочаквани конфигурации.

6.4 Какво означава overwrite на практика

Примерна структура:

/themes/ms/theme.json
/themes/ms/base/theme.json
/themes/ms/base/none/index.php

/themes/ms/theme.json
/themes/ms/base/theme.json
/themes/ms/base/none/index.php

6.5 Какво НЕ се прави
- ❌ няма merge между конфигурации
- ❌ няма implicit inheritance
- ❌ няма runtime override
- ❌ темата НЕ знае откъде идва конфигурацията
Всичко се resolve-ва в resolveTheme().

6.6 Връзка с engine-level файлове
- cms_assets.php и functions.php се зареждат на ниво engine
  (напр. /themes/ms/)
- те НЕ участват в overwrite логиката
- всички подтеми автоматично ги използват
theme.json контролира поведение, не файлова логика.

6.6 Връзка с engine-level файлове
- cms_assets.php и functions.php се зареждат на ниво engine
  (напр. /themes/ms/)
- те НЕ участват в overwrite логиката
- всички подтеми автоматично ги използват
theme.json контролира поведение, не файлова логика.

7. Статус на спецификацията
- Version: v1.1
- Change: overwrite cascade вместо merge
- Backward compatible: Да
- Runtime cost: минимален
...
Теми и дизайни
Начало / Услуги / Поддръжка на сайт / Документация...

Максофт е дигитална агенция със собствени продукти за изработка, поддръжка, 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)

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

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

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

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

Описание:

cms_assets.php

functions.php

/helpers

/components

5. Theme-level структура (пример: /themes/ms/base/none)

6. Theme configuration (theme.json) – overwrite resolution

6.1 Статус на theme.json

6.2 Правило за overwrite (основно правило)

6. Theme configuration (theme.json) – overwrite resolution

6.1 Статус на theme.json

6.2 Правило за overwrite (основно правило)

6.3 Алгоритъм за търсене на theme.json

6.4 Какво означава overwrite на практика

6.5 Какво НЕ се прави

6.6 Връзка с engine-level файлове

6.6 Връзка с engine-level файлове

7. Статус на спецификацията

За нас

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

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

SEO

Нашият опит

Следвайте ни

Запитване

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

За нас

Връзки

Контакти

`/themes` – Official Theme Architecture Spec (v1)

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

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

`cms_assets.php`

`functions.php`

`/helpers`

`/components`

5. Theme-level структура (пример: `/themes/ms/base/none`)

6. Theme configuration (`theme.json`) – overwrite resolution

6.1 Статус на `theme.json`

6. Theme configuration (`theme.json`) – overwrite resolution

6.1 Статус на `theme.json`

6.3 Алгоритъм за търсене на `theme.json`