# HOC Site Docs

> Documentation for HOC Site: websites, design, objects, settings, and integrations.

## Getting started

- [Getting started](https://docs.hoc-site.com/en/getting-started): HOC Site handles the infrastructural work of launching a website or web app: hosting concerns, multi-locale publishing, theming, layouts, object data models, file storage, access control, and design editors. Everything is pure-schema-driven: pages, objects, lifecycles, permissions, and templates are data you configure, not hidden product logic. That means full consistency across sites, no surprise behavior, and perfect recreation when you export, import, or seed from a template. You focus on content and product behavior; the platform provides the shared foundation underneath.
- [Websites](https://docs.hoc-site.com/en/getting-started/websites): A website is the top-level container for design surfaces, objects, settings, files, and access. Everything on a website is pure-schema-driven: the same models and editors power every site, with no hidden per-site logic, so behavior stays consistent and recreation (from templates or exports) stays faithful. New websites start in preview mode until a subscription is active.
- [Templates](https://docs.hoc-site.com/en/getting-started/templates): Templates are pure schema seeds for a new website. They copy object types, pages, roles, and related starting structure so you have something to build on. They do not hold bespoke application logic, custom code paths, hidden runtime behavior, or special product forks, after create, the site uses the same schema-driven platform capabilities as any other website. That is what makes recreation perfect: export, import, or re-apply a template and you get the same structured starting point. Prefer a matching template over blank when it saves setup time.

## Interfaces

- [Interfaces](https://docs.hoc-site.com/en/interfaces): Ways to interact with HOC Site: the browser admin panel, Model Context Protocol (MCP) for AI agents and tools, and the REST API for direct HTTP access. They all use the same platform account.
- [Admin panel](https://docs.hoc-site.com/en/interfaces/admin-panel): The visual UI for managing websites, pages, objects, settings, and more. Install the panel as an app on supported browsers, and opt into admin push alerts for new entries.
- [AI Agents (MCP)](https://docs.hoc-site.com/en/interfaces/mcp): HOC Site MCP lets AI agents and MCP clients use the same platform capabilities over HTTP.
- [API](https://docs.hoc-site.com/en/interfaces/api): The versioned REST API under /api/v1 for programmatic access to websites and related resources.

## Design

- [Design](https://docs.hoc-site.com/en/design): Block catalogs and shared decoration/visibility for pages, headers, footers, and components.
- [Page](https://docs.hoc-site.com/en/design/page): Route page design. Content is merged design Data for one website locale.
- [Site header](https://docs.hoc-site.com/en/design/chrome-header): Global header design for the public website.
- [Site footer](https://docs.hoc-site.com/en/design/chrome-footer): Global footer design for the public website.
- [Page component](https://docs.hoc-site.com/en/design/page-component): Reusable page components referenced from pages via PageComponentBlock.
- [Object component](https://docs.hoc-site.com/en/design/object-component): Templates for object detail/list/form views. Bound fields depend on the object type field schema.
- [Email header](https://docs.hoc-site.com/en/design/email-chrome-header): Header for outbound website emails.
- [Email footer](https://docs.hoc-site.com/en/design/email-chrome-footer): Footer for outbound website emails.

### Shared concepts

- [Shared concepts](https://docs.hoc-site.com/en/design/shared-concepts): Reusable design fields and behavior shared by blocks across multiple editors.
- [Decoration & visibility (BlockShell)](https://docs.hoc-site.com/en/design/shared-concepts/block-shell): Field-level catalog tables below stay in English — they match the machine design schema used by the editor, API, and MCP.
- [Rich text](https://docs.hoc-site.com/en/design/shared-concepts/rich-text): TipTap HTML used by RichTextBlock, button labels, overlays, and object-bound rich text. Storage shape, toolbar features, and authoring rules are documented here.
- [Icons](https://docs.hoc-site.com/en/design/shared-concepts/icons): Button and button-link fields use this shared icon set. Pick an id in the editor; use none for no icon.
- [Field options](https://docs.hoc-site.com/en/design/shared-concepts/options): Shared enum and select values used across design blocks, presentation, appearance, action, visibility, and more.

## Objects

- [Objects](https://docs.hoc-site.com/en/objects): Objects are the structured data models for a website: types, fields (including picker-built calculated fields), entries, permissions, components, and lifecycles. Content kinds store app data; a user-kind type backs signed-in website members. Definitions stay pure-schema-driven so recreation and behavior stay consistent across interfaces.
- [Types](https://docs.hoc-site.com/en/objects/types): # Object types
- [Fields](https://docs.hoc-site.com/en/objects/fields): # Object fields
- [Permissions](https://docs.hoc-site.com/en/objects/permissions): # Object permissions
- [Lifecycles](https://docs.hoc-site.com/en/objects/lifecycles): Automate emails, in-app and browser push notifications, field updates, timed schedules, and create-entry actions when entries are created or changed (schema-driven; up to 20 events per object type).
- [Entries](https://docs.hoc-site.com/en/objects/entries): Entries are records of an object type. Values live in fieldValues; localized fields use localizedValuesByLocale. Status is draft or published when publishing is enabled.
- [Components](https://docs.hoc-site.com/en/objects/components): # Object components

## Website settings

- [Website settings](https://docs.hoc-site.com/en/settings): Website settings cover identity, favicon and install-as-app, member web push, locales, custom domains, outbound email, external link allowlists, and privacy-aware public web integrations (verification and tracking tags such as GTM).
- [Favicon & install as app](https://docs.hoc-site.com/en/settings/favicon): Upload one square source image to generate the site favicon set, then optionally enable a web app manifest so browsers can offer “install as app” / Add to Home Screen. Configure in admin Website settings → Identity (website superadmin). There is no REST or MCP API for these controls yet.
- [Locales](https://docs.hoc-site.com/en/settings/locales): Each website has a primary locale and a list of enabled locales used for publishing and the public site.
- [Domains](https://docs.hoc-site.com/en/settings/domains): Add custom domains for the website. New domains start unverified. Verification and some plan operations are admin UI / manual MCP only.
- [Email](https://docs.hoc-site.com/en/settings/email): Configure how transactional email is sent: platform delivery or your own SMTP. Responses never return the raw SMTP password; they expose hasSmtpPassword instead.
- [External linking](https://docs.hoc-site.com/en/settings/external-linking): Restrict or allow outbound link hosts used by the site. The PUT body is a list of domain strings.
- [Web integrations](https://docs.hoc-site.com/en/settings/web-integrations): Store verification codes and measurement IDs on the website. Once the site is active (not preview), the public layout injects the matching meta tags and scripts. Configure in the admin settings UI, or via API/MCP as website superadmin. PUT fully replaces the integration map, omit a key or send an empty string to clear it.
- [Web push](https://docs.hoc-site.com/en/settings/web-push): Optional browser push for signed-in website members when they receive in-app notifications (for example from lifecycle create_notification actions). Configure per website in admin Website settings → Identity (website superadmin). There is no REST or MCP API for VAPID keys yet.

## Access

- [Access](https://docs.hoc-site.com/en/access): Access has two layers. Platform roles and users administer the website in the admin panel, API, and MCP. Website roles and users are signed-in visitors on the public site, backed by a user-kind object type. Object-entry grants stay role checkboxes (own vs others). Optional structured conditions on a grant further restrict which entries match — for example the same department as the viewer, or mutate only within 30 minutes of creation. Empty conditions keep today's RBAC behavior. Super-admin, site-wide platform flags, and HOC operator roles stay boolean.
- [Platform roles](https://docs.hoc-site.com/en/access/platform-roles): Platform roles define admin capabilities on this website. Built-in special roles such as super_admin and admin cannot be mutated like custom roles.
- [Platform users](https://docs.hoc-site.com/en/access/platform-users): Platform users are platform accounts that can open this website in the admin panel. Invite is admin UI only; the API lists users, changes custom roles, and revokes access.
- [Website roles](https://docs.hoc-site.com/en/access/website-roles): Website roles apply to signed-in public-site members. They are defined on a user-kind object type at /objects/{objectTypeId}/user-roles.
- [Website users](https://docs.hoc-site.com/en/access/website-users): There is no separate /website-users collection. Website users are entries of the user-kind object type. Assign roles with the assign endpoint.

## Files

- [Files](https://docs.hoc-site.com/en/files): Files and directories store media and documents used by pages, objects, and email. Uploads are multipart on the REST API; MCP accepts base64 and converts to multipart.
- [Directories](https://docs.hoc-site.com/en/files/directories): Directories nest under an optional parent. Deleting a directory cascades nested directories and clears directory_id on contained files.

## Theme

- [Theme](https://docs.hoc-site.com/en/theme): Theme tokens and layout breakpoints keep the public site visually consistent across pages and chrome.

## Layout

- [Layout](https://docs.hoc-site.com/en/layout): Layout controls the content column width and breakpoint definitions used by the site shell and blocks.

## Statistics

- [Statistics](https://docs.hoc-site.com/en/statistics): Insights summarize traffic and operational signals for a website: statistics over a day range, and entry reports submitted by visitors.

## Reports

- [Reports](https://docs.hoc-site.com/en/reports): Entry reports capture visitor feedback or flags on object entries. Filter by open or resolved, inspect one report, or mark it resolved.

## Türkçe

### Başlangıç

- [Başlangıç](https://docs.hoc-site.com/tr/getting-started): HOC Site, bir web sitesi veya web uygulaması başlatmanın altyapı işlerini üstlenir: barındırma endişeleri, çok dilli yayınlama, tema, düzenler, nesne veri modelleri, dosya depolama, erişim kontrolü ve tasarım editörleri. Her şey saf şema odaklıdır: sayfalar, nesneler, yaşam döngüleri, izinler ve şablonlar yapılandırdığınız veridir; gizli ürün mantığı yoktur. Bu, siteler arasında tam tutarlılık, sürpriz davranış olmaması ve dışa/içe aktarma ya da şablondan tohumlama ile mükemmel yeniden oluşturma demektir. Siz içerik ve ürün davranışına odaklanırsınız; platform altındaki ortak temeli sağlar.
- [Web siteleri](https://docs.hoc-site.com/tr/getting-started/websites): Bir web sitesi; tasarım yüzeyleri, nesneler, ayarlar, dosyalar ve erişim için üst düzey kapsayıcıdır. Sitedeki her şey saf şema odaklıdır: her siteyi aynı modeller ve editörler güçlendirir, siteye özel gizli mantık yoktur, davranış tutarlı kalır ve yeniden oluşturma (şablonlardan veya dışa aktarımlardan) sadık kalır. Yeni siteler abonelik etkin olana kadar önizleme kipinde başlar.
- [Şablonlar](https://docs.hoc-site.com/tr/getting-started/templates): Şablonlar yeni bir web sitesi için saf şema tohumlarıdır. Nesne türlerini, sayfaları, rolleri ve ilgili başlangıç yapısını kopyalayarak üzerine inşa edebileceğiniz bir temel sağlarlar. Özel uygulama mantığı, özel kod yolları, gizli çalışma zamanı davranışı veya özel ürün çatalları taşımazlar. Oluşturma sonrası site, diğer tüm sitelerle aynı şema odaklı platform yeteneklerini kullanır. Yeniden oluşturmayı mükemmel kılan budur: dışa aktarın, içe aktarın veya şablonu yeniden uygulayın; aynı yapılandırılmış başlangıç noktasını alırsınız. Kurulumu kısaltıyorsa boş yerine uygun bir şablon tercih edin.

### Arayüzler

- [Arayüzler](https://docs.hoc-site.com/tr/interfaces): HOC Site ile etkileşim yolları: tarayıcıdaki yönetim paneli, yapay zeka aracıları ve araçlar için Model Context Protocol (MCP) ve doğrudan HTTP erişimi için REST API. Hepsi aynı platform hesabını kullanır.
- [Yönetim paneli](https://docs.hoc-site.com/tr/interfaces/admin-panel): Web siteleri, sayfalar, nesneler, ayarlar ve daha fazlasını yönetmek için görsel arayüz. Desteklenen tarayıcılarda paneli uygulama olarak yükleyin ve yeni kayıtlar için yönetici push uyarılarına katılın.
- [Yapay zeka aracıları (MCP)](https://docs.hoc-site.com/tr/interfaces/mcp): HOC Site MCP, yapay zeka aracılarının ve MCP istemcilerinin aynı platform yeteneklerini HTTP üzerinden kullanmasını sağlar.
- [API](https://docs.hoc-site.com/tr/interfaces/api): Web sitelerine ve ilgili kaynaklara programatik erişim için /api/v1 altındaki sürümlü REST API.

### Tasarım

- [Tasarım](https://docs.hoc-site.com/tr/design): Sayfa, üstbilgi, altbilgi ve bileşenler için blok katalogları ve ortak dekorasyon/görünürlük.
- [Sayfa](https://docs.hoc-site.com/tr/design/page): Route page design. Content is merged design Data for one website locale.
- [Site üstbilgi](https://docs.hoc-site.com/tr/design/chrome-header): Global header design for the public website.
- [Site altbilgi](https://docs.hoc-site.com/tr/design/chrome-footer): Global footer design for the public website.
- [Sayfa bileşeni](https://docs.hoc-site.com/tr/design/page-component): Reusable page components referenced from pages via PageComponentBlock.
- [Nesne bileşeni](https://docs.hoc-site.com/tr/design/object-component): Templates for object detail/list/form views. Bound fields depend on the object type field schema.
- [E-posta üstbilgi](https://docs.hoc-site.com/tr/design/email-chrome-header): Header for outbound website emails.
- [E-posta altbilgi](https://docs.hoc-site.com/tr/design/email-chrome-footer): Footer for outbound website emails.

#### Ortak kavramlar

- [Ortak kavramlar](https://docs.hoc-site.com/tr/design/shared-concepts): Birden fazla düzenleyicideki bloklar tarafından paylaşılan yeniden kullanılabilir tasarım alanları ve davranışları.
- [Dekorasyon ve görünürlük (BlockShell)](https://docs.hoc-site.com/tr/design/shared-concepts/block-shell): Aşağıdaki alan düzeyi katalog tabloları İngilizce kalır — düzenleyici, API ve MCP’nin kullandığı makine tasarım şemasıyla birebir uyumludur.
- [Zengin metin](https://docs.hoc-site.com/tr/design/shared-concepts/rich-text): RichTextBlock, düğme etiketleri, kaplamalar ve nesneye bağlı zengin metinde kullanılan TipTap HTML. Depolama biçimi, araç çubuğu özellikleri ve yazarlık kuralları burada belgelenir.
- [İkonlar](https://docs.hoc-site.com/tr/design/shared-concepts/icons): Düğme ve düğme bağlantısı alanları bu ortak ikon setini kullanır. Düzenleyicide bir kimlik seçin; ikon istemiyorsanız none kullanın.
- [Alan seçenekleri](https://docs.hoc-site.com/tr/design/shared-concepts/options): Tasarım bloklarında paylaşılan enum ve seçim değerleri: sunum (presentation), görünüm, eylem, görünürlük ve daha fazlası.

### Nesneler

- [Nesneler](https://docs.hoc-site.com/tr/objects): Nesneler bir web sitesinin yapılandırılmış veri modelleridir: türler, alanlar (seçiciyle kurulan hesaplanan alanlar dahil), kayıtlar, izinler, bileşenler ve yaşam döngüleri. İçerik türleri uygulama verisini saklar; user türü oturum açmış site üyelerini destekler. Tanımlar saf şema odaklı kaldığı için yeniden oluşturma ve davranış arayüzler arasında tutarlıdır.
- [Türler](https://docs.hoc-site.com/tr/objects/types): # Nesne türleri
- [Alanlar](https://docs.hoc-site.com/tr/objects/fields): # Nesne alanları
- [İzinler](https://docs.hoc-site.com/tr/objects/permissions): # Nesne izinleri
- [Yaşam döngüleri](https://docs.hoc-site.com/tr/objects/lifecycles): Kayıtlar oluşturulduğunda veya değiştiğinde e-posta, uygulama içi ve tarayıcı bildirimleri, alan güncellemeleri, zamanlanmış tetikleyiciler ve kayıt oluşturma eylemlerini otomatikleştirin (şema odaklı; nesne türü başına en fazla 20 olay).
- [Kayıtlar](https://docs.hoc-site.com/tr/objects/entries): Kayıtlar bir nesne türünün satırlarıdır. Değerler fieldValues içindedir; yerelleştirilmiş alanlar localizedValuesByLocale kullanır. Yayınlama açıksa durum draft veya published olur.
- [Bileşenler](https://docs.hoc-site.com/tr/objects/components): # Nesne bileşenleri

### Site ayarları

- [Site ayarları](https://docs.hoc-site.com/tr/settings): Site ayarları kimlik, favicon ve uygulamaya yükleme, üye web push, diller, özel alan adları, giden e-posta, dış bağlantı izin listeleri ve gizlilik odaklı genel web entegrasyonlarını (GTM gibi doğrulama ve izleme etiketleri) kapsar.
- [Favicon ve uygulamaya yükleme](https://docs.hoc-site.com/tr/settings/favicon): Tek bir kare kaynak görsel yükleyerek site favicon setini üretin; isteğe bağlı olarak web uygulama bildirimini etkinleştirerek tarayıcıların “uygulama olarak yükle” / Ana Ekrana Ekle sunmasını sağlayın. Yönetimde Site ayarları → Kimlik altında yapılandırın (site süper yöneticisi). Bu kontroller için henüz REST veya MCP API yoktur.
- [Diller](https://docs.hoc-site.com/tr/settings/locales): Her sitenin bir birincil dili ve yayınlama ile kamuya açık site için etkin diller listesi vardır.
- [Alan adları](https://docs.hoc-site.com/tr/settings/domains): Site için özel alan adları ekleyin. Yeni alan adları doğrulanmamış başlar. Doğrulama ve bazı plan işlemleri yalnızca yönetim paneli / manuel MCP’dedir.
- [E-posta](https://docs.hoc-site.com/tr/settings/email): İşlemsel e-postanın nasıl gönderileceğini yapılandırın: platform veya kendi SMTP’niz. Yanıtlar ham SMTP parolasını döndürmez; bunun yerine hasSmtpPassword gösterir.
- [Harici bağlantı](https://docs.hoc-site.com/tr/settings/external-linking): Sitenin kullandığı giden bağlantı sunucularını kısıtlayın veya izin verin. PUT gövdesi alan adı dizgesidir.
- [Web entegrasyonları](https://docs.hoc-site.com/tr/settings/web-integrations): Sitede doğrulama kodlarını ve ölçüm kimliklerini saklayın. Site etkin (önizleme değil) olduğunda genel düzen eşleşen meta etiketleri ve betikleri enjekte eder. Yönetim ayarları arayüzünden veya site süper yöneticisi olarak API/MCP üzerinden yapılandırın. PUT entegrasyon haritasını tamamen değiştirir: bir anahtarı atlamak veya boş dize göndermek onu temizler.
- [Web push](https://docs.hoc-site.com/tr/settings/web-push): Oturum açmış site üyeleri uygulama içi bildirim aldığında (örneğin yaşam döngüsü create_notification eylemlerinden) isteğe bağlı tarayıcı push. Site başına yönetimde Site ayarları → Kimlik altında yapılandırın (site süper yöneticisi). VAPID anahtarları için henüz REST veya MCP API yoktur.

### Erişim

- [Erişim](https://docs.hoc-site.com/tr/access): Erişimin iki katmanı vardır. Platform rolleri ve kullanıcıları siteyi yönetim paneli, API ve MCP’de yönetir. Web sitesi rolleri ve kullanıcıları kamuya açık sitedeki oturum açmış ziyaretçilerdir; user türündeki bir nesne türüne dayanır. Kayıt izinleri rol onay kutularıdır (kendi / diğerleri). Bir izne isteğe bağlı yapılandırılmış koşullar eklenebilir — örneğin görüntüleyenle aynı birim, veya oluşturmadan 30 dakika sonra düzenlemeyi kapatmak. Boş koşullar bugünkü RBAC davranışını korur. Süper yönetici, site genelindeki platform bayrakları ve HOC operatör rolleri boolean kalır.
- [Platform rolleri](https://docs.hoc-site.com/tr/access/platform-roles): Platform rolleri bu sitedeki yönetim yeteneklerini tanımlar. super_admin ve admin gibi özel roller özel roller gibi değiştirilemez.
- [Platform kullanıcıları](https://docs.hoc-site.com/tr/access/platform-users): Platform kullanıcıları bu siteyi yönetim panelinde açabilen platform hesaplarıdır. Davet yalnızca yönetim panelindedir; API kullanıcıları listeler, özel rolleri değiştirir ve erişimi iptal eder.
- [Web sitesi rolleri](https://docs.hoc-site.com/tr/access/website-roles): Web sitesi rolleri kamuya açık sitede oturum açmış üyeler için geçerlidir. user türündeki nesne türünde /objects/{objectTypeId}/user-roles altında tanımlanır.
- [Web sitesi kullanıcıları](https://docs.hoc-site.com/tr/access/website-users): Ayrı bir /website-users koleksiyonu yoktur. Web sitesi kullanıcıları user türündeki kayıtlardır. Rolleri assign uç noktasıyla atayın.

### Dosyalar

- [Dosyalar](https://docs.hoc-site.com/tr/files): Dosyalar ve klasörler sayfalar, nesneler ve e-posta tarafından kullanılan medya ve belgeleri saklar. REST API’de yüklemeler multipart’tır; MCP base64 alıp multipart’a çevirir.
- [Klasörler](https://docs.hoc-site.com/tr/files/directories): Klasörler isteğe bağlı bir üst klasör altında yuvalanır. Silme iç içe klasörleri siler ve dosyalardaki directory_id değerini temizler.

### Tema

- [Tema](https://docs.hoc-site.com/tr/theme): Tema token’ları ve düzen kırılım noktaları kamuya açık siteyi sayfalar ve chrome boyunca görsel olarak tutarlı tutar.

### Düzen

- [Düzen](https://docs.hoc-site.com/tr/layout): Düzen, site kabuğu ve blokların kullandığı içerik sütunu genişliğini ve kırılım tanımlarını kontrol eder.

### İstatistikler

- [İstatistikler](https://docs.hoc-site.com/tr/statistics): İçgörüler bir site için trafik ve operasyon sinyallerini özetler: gün aralığında istatistikler ve ziyaretçilerin gönderdiği kayıt raporları.

### Raporlar

- [Raporlar](https://docs.hoc-site.com/tr/reports): Kayıt raporları ziyaretçi geri bildirimi veya işaretlerini tutar. open veya resolved ile filtreleyin, bir raporu inceleyin veya çözüldü işaretleyin.

## Agent resources

- [llms-full.txt](https://docs.hoc-site.com/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.hoc-site.com/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [MCP server](https://docs.hoc-site.com/mcp): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: https://docs.hoc-site.com/.well-known/mcp.json
- [API catalog](https://docs.hoc-site.com/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [agent-readability.json](https://docs.hoc-site.com/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.hoc-site.com/sitemap.xml): Every indexable page URL with its last-modified date.