From bd349b154441da5f741137c3787415877bfc1c7e Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 10 Jul 2026 11:41:55 +0200 Subject: [PATCH] i18n - docs translations (#22777) Created by Github action Review in cubic Co-authored-by: github-actions --- .../ar/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 12 ++++++------ .../cs/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 12 ++++++------ .../de/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 12 ++++++------ .../es/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 10 ++++------ .../fr/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 12 ++++++------ .../it/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 12 ++++++------ .../ja/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 10 +++++----- .../ko/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 9 +++++---- .../pt/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 12 ++++++------ .../ro/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 12 ++++++------ .../tr/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 9 +++++---- .../zh/developers/extend/apps/config/application.mdx | 8 ++++++-- .../developers/extend/apps/config/public-assets.mdx | 2 +- .../apps/getting-started/project-structure.mdx | 3 ++- .../developers/extend/apps/operations/publishing.mdx | 12 ++++++------ .../apps/tutorials/document-generator/publishing.mdx | 12 ++++++------ 60 files changed, 247 insertions(+), 187 deletions(-) diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx index 83658680da..36b0df426b 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ const config = JSON.parse(process.env.PROVIDER_CONFIG ?? '{}'); // '{"retries":3 | ------------------ | ------------------------------------------------------------------------------------------------------------ | | `author` | اسم المؤلف أو الشركة | | `category` | فئة التطبيق لتصفية سوق التطبيقات | -| `logoUrl` | مسار شعار تطبيقك (مثلًا، `public/logo.png`) | -| `screenshots` | مصفوفة لمسارات لقطات الشاشة (مثلًا، `public/screenshot-1.png`) | +| `logo` | مسار شعار تطبيقك المضمَّن في `public/` (مثلًا، `public/logo.png`) | +| `galleryImages` | مصفوفة لمسارات صور المعرض المضمَّنة في `public/` (مثلًا، `public/screenshot-1.png`) | | `aboutDescription` | وصف ماركداون أطول لعلامة التبويب "حول". إذا لم يتم تضمينه، يستخدم السوق ملف `README.md` الخاص بالحزمة من npm | | `websiteUrl` | رابط إلى موقعك الإلكتروني | | `termsUrl` | رابط إلى شروط الخدمة | | `emailSupport` | عنوان البريد الإلكتروني للدعم | | `issueReportUrl` | رابط إلى متتبّع المشاكل | + + +القيمتان `logoUrl` و`screenshots` هما اسمَان مهملان بديلان لـ`logo` و`galleryImages`. عناوين URLs المطلقة الخارجية (`http://` أو `https://`) غير مدعومة لهذه الحقول: سيتم تجاهلها مع إظهار تحذير وقت البناء. بدلًا من ذلك، ضمِّن الصور في مجلد `public/` الخاص بتطبيقك. + diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/config/public-assets.mdx index f1d8e01cff..36f1d2c4f1 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ icon: folder-open * **متاحة للعامة** — بمجرد مزامنتها إلى الخادم، تُقدَّم الأصول عبر عنوان URL عام. لا حاجة إلى مصادقة للوصول إليها. * **متاحة في المكوّنات الأمامية** — استخدم عناوين الأصول لعرض الصور أو الأيقونات أو أي وسائط داخل مكوّنات React لديك. * **متاحة في الدوال المنطقية** — أشِر إلى عناوين الأصول في رسائل البريد الإلكتروني أو استجابات واجهات البرمجة أو أي منطق على جهة الخادم. -* **مستخدمة لبيانات تعريف السوق** — يشير حقلا `logoUrl` و`screenshots` في `defineApplication()` إلى ملفات من هذا المجلد (مثل `public/logo.png`). تُعرَض هذه عند نشر تطبيقك في السوق. +* **مستخدمة لبيانات تعريف السوق** — يشير حقلا `logo` و`galleryImages` في `defineApplication()` إلى ملفات من هذا المجلد (مثل `public/logo.png`). تُعرَض هذه عند نشر تطبيقك في السوق. يتم تجاهل عناوين URL المطلقة الخارجية لهذه الحقول — بدلاً من ذلك، قم بتجميع الصور في `public/`. * **تُزامَن تلقائيًا في وضع التطوير** — عند إضافة ملف في `public/` أو تحديثه أو حذفه، تتم مزامنته إلى الخادم تلقائيًا. لا حاجة لإعادة التشغيل. * **مضمَّنة في عمليات البناء** — يقوم `yarn twenty dev:build` بتجميع جميع الأصول العامة ضمن مخرجات التوزيع. diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/project-structure.mdx index eec0580c0e..8d403e4a7a 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## الملفات الرئيسية @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | اختبار وحدة بالإضافة إلى اختبار تكامل (مع إعداده العام) يقوم بمزامنة التطبيق مع خادم حقيقي. | | `public/` | أصول ثابتة (صور، خطوط) تُقدَّم مع تطبيقك. | | `AGENTS.md` / `CLAUDE.md` | إرشادات لوكلاء برمجة الذكاء الاصطناعي الذين يعملون على التطبيق. | +| `CHANGELOG.md` / `SETUP.md` | سجل بأبرز التغييرات وتعليمات الإعداد للتطوير المحلي. | **تنظيم الملفات متروك لك.** المجلدات المذكورة أعلاه هي أعراف متَّبعة — يكتشف SDK الكيانات عبر تحليل AST على استدعاءات `export default defineEntity(...)` بغض النظر عن مكان وجود الملف. diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/operations/publishing.mdx index 3c8f05c923..464e774b8d 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ yarn twenty app:publish --private ### بيانات التعريف لسوق التطبيقات -يدعم إعداد `defineApplication()` حقولًا اختيارية تتحكم في كيفية ظهور تطبيقك في السوق. استخدم `logoUrl` و`screenshots` للإشارة إلى الصور من مجلد `public/`: +يدعم إعداد `defineApplication()` حقولًا اختيارية تتحكم في كيفية ظهور تطبيقك في السوق. استخدم `logo` و`galleryImages` للإشارة إلى الصور من مجلد `public/`: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ اطّلع على [أكورديون defineApplication](/l/ar/developers/extend/apps/config/application#marketplace-metadata) في صفحة بناء التطبيقات للاطلاع على القائمة الكاملة لحقول السوق (`author` و`category` و`aboutDescription` و`websiteUrl` و`termsUrl` وغيرها). -#### أبعاد لقطات الشاشة الموصى بها +#### أبعاد صور المعرض الموصى بها -يعرض السوق `screenshots` داخل حاوية ثابتة بنسبة `8:5` (على سبيل المثال، `1600×1000 px`). +يعرض السوق `galleryImages` داخل حاوية ثابتة بنسبة `8:5` (على سبيل المثال، `1600×1000 px`). -تعرض لقطات الشاشة بأي نسبة عرض إلى ارتفاع بالكامل ولن يتم اقتطاعها مطلقًا، ولكن أي شيء أطول أو أضيق بكثير من `8:5` سيظهر مساحات فارغة على الجانبين. +تُعرض صور المعرض بأي نسبة عرض إلى ارتفاع بالكامل ولن يتم اقتطاعها مطلقًا، ولكن أي شيء أطول أو أضيق بكثير من `8:5` سيظهر مساحات فارغة على الجانبين. ### النشر diff --git a/packages/twenty-docs/l/ar/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/ar/developers/extend/apps/tutorials/document-generator/publishing.mdx index 4f9d039acd..1dc2771ad3 100644 --- a/packages/twenty-docs/l/ar/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/ar/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ description: إضافة بيانات التعريف للسوق ونشر التط [config](/l/ar/developers/extend/apps/config/application) يحمل الهوية التي تظهر في السوق: روابط المؤلف والفئة والشعار والدعم -. ضع الشعار في `public/` وقم بالرجوع إليه مع `logoUrl`. +. ضع شعارًا في `public/` وارجع إليه باستخدام `logo`. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/ar/developers/extend/apps', @@ -43,14 +43,14 @@ export default defineApplication({ ## إضافة لقطات شاشة معرض الصور -قائمة السوق تبيع نفسها مع لقطات شاشة. إسقاط عدد قليل من PNGs في -`public/gallery/` والإشارة إليهم بـ \`screenshots' - يتم عرضهم كمعرض -في صفحة الإدراج في القائمة. +قائمة السوق تبيع نفسها مع لقطات شاشة. ضع بعض ملفات PNG في +`public/gallery/` وارجع إليها باستخدام `galleryImages` — حيث يتم عرضها كمعرض +على صفحة القائمة، بحسب ترتيبها في المصفوفة. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx index 00ece324b5..176d6236e3 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ Pokud plánujete [zveřejnit svou aplikaci](/l/cs/developers/extend/apps/operati | ------------------ | ------------------------------------------------------------------------------------------------------------- | | `author` | Jméno autora nebo název společnosti | | `category` | Kategorie aplikace pro filtrování v tržišti | -| `logoUrl` | Cesta k logu vaší aplikace (např. `public/logo.png`) | -| `screenshots` | Pole cest ke snímkům obrazovky (např. `public/screenshot-1.png`) | +| `logo` | Cesta k logu vaší aplikace v balíčku v `public/` (např. `public/logo.png`) | +| `galleryImages` | Pole cest ke snímkům galerie v balíčku v `public/` (např. `public/screenshot-1.png`) | | `aboutDescription` | Delší popis v Markdownu pro kartu "O aplikaci". Pokud je vynecháno, tržiště použije `README.md` balíčku z npm | | `websiteUrl` | Odkaz na váš web | | `termsUrl` | Odkaz na podmínky služby | | `emailSupport` | E-mailová adresa podpory | | `issueReportUrl` | Odkaz na nástroj pro sledování problémů | + + +`logoUrl` a `screenshots` jsou zastaralé aliasy `logo` a `galleryImages`. Externí absolutní adresy URL (`http://` nebo `https://`) nejsou pro tato pole podporovány: při sestavení jsou vynechány s varováním. Místo toho přiložte obrázky do složky `public/` vaší aplikace. + diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/config/public-assets.mdx index 6d6495c04e..f118161c30 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ Soubory umístěné v `public/` jsou: * **Veřejně přístupné** — po synchronizaci na server jsou prostředky dostupné na veřejné URL. K přístupu k nim není potřeba žádná autentizace. * **Dostupné ve frontendových komponentách** — použijte URL prostředků k zobrazení obrázků, ikon či jiných médií uvnitř komponent Reactu. * **Dostupné v logických funkcích** — odkazujte na URL prostředků v e-mailech, odpovědích API či jiné serverové logice. -* **Používány pro metadata Marketplace** — pole `logoUrl` a `screenshots` v `defineApplication()` odkazují na soubory z této složky (např. `public/logo.png`). Zobrazují se v Marketplace, když je vaše aplikace zveřejněna. +* **Používány pro metadata Marketplace** — pole `logo` a `galleryImages` v `defineApplication()` odkazují na soubory z této složky (např. `public/logo.png`). Zobrazují se v Marketplace, když je vaše aplikace zveřejněna. Pro tato pole jsou externí absolutní adresy URL ignorovány — místo toho přibalte obrázky do `public/`. * **Automaticky synchronizované ve vývojovém režimu** — když v `public/` přidáte, aktualizujete nebo smažete soubor, je automaticky synchronizován na server. Není potřeba restartovat. * **Zahrnuté do buildů** — `yarn twenty dev:build` zabalí všechny veřejné prostředky do distribučního výstupu. diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/project-structure.mdx index c1b775c104..8faaac2621 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## Klíčové soubory @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | Jednotkový test plus integrační test (s jeho globálním nastavením), který synchronizuje aplikaci proti skutečnému serveru. | | `public/` | Statické soubory (obrázky, písma) doručované vaší aplikací. | | `AGENTS.md` / `CLAUDE.md` | Pokyny pro agenty AI pro psaní kódu, kteří pracují na aplikaci. | +| `CHANGELOG.md` / `SETUP.md` | Seznam významných změn a pokyny k nastavení pro lokální vývoj. | **Uspořádání souborů je na vás.** Výše uvedené složky jsou konvence — SDK detekuje entity pomocí analýzy AST u volání `export default defineEntity(...)` bez ohledu na to, kde se soubor nachází. diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/operations/publishing.mdx index 0926d7534c..016050ca8b 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ Publikování na npm zajistí, že bude vaše aplikace dohledatelná v Marketpla ### Metadata tržiště -Konfigurace `defineApplication()` podporuje volitelná pole, která určují, jak se vaše aplikace zobrazuje v tržišti. Použijte `logoUrl` a `screenshots` k odkazování na obrázky ze složky `public/`: +Konfigurace `defineApplication()` podporuje volitelná pole, která určují, jak se vaše aplikace zobrazuje v tržišti. Použijte `logo` a `galleryImages` k odkazování na obrázky ze složky `public/`: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ Podívejte se na [sekci defineApplication](/l/cs/developers/extend/apps/config/application#marketplace-metadata) na stránce Building Apps pro úplný seznam polí tržiště (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl` atd.). -#### Doporučené rozměry snímků obrazovky +#### Doporučené rozměry obrázků v galerii -Tržiště zobrazuje `screenshots` v pevném kontejneru s poměrem stran `8:5` (například `1600×1000 px`). +Tržiště zobrazuje `galleryImages` v pevném kontejneru s poměrem stran `8:5` (například `1600×1000 px`). -Snímky obrazovky libovolného poměru stran se zobrazují celé a nikdy se neořezávají, ale cokoli výrazně vyššího nebo užšího než `8:5` bude mít po stranách prázdné pruhy. +Obrázky v galerii libovolného poměru stran se zobrazují celé a nikdy se neořezávají, ale cokoli výrazně vyššího nebo užšího než `8:5` bude mít po stranách prázdné pruhy. ### Publikování diff --git a/packages/twenty-docs/l/cs/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/cs/developers/extend/apps/tutorials/document-generator/publishing.mdx index 7ba785b6b5..c7189ecedf 100644 --- a/packages/twenty-docs/l/cs/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/cs/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ Vaše aplikace funguje. Posledním krokem je popsat jej pro tržiště a publiko [application config](/l/cs/developers/extend/apps/config/application) nese identitu, která se objeví v tržišti: autor, kategorie, logo a podpora -. Vložte logo do `public/` a odkazujte na `logoUrl`. +. Umístěte logo do `public/` a odkažte se na něj pomocí `logo`. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/cs/developers/extend/apps', @@ -43,14 +43,14 @@ Přidejte také klíčové slovo `dvacet app` do `package.json` tak, aby byla ap ## Přidat galerii snímků obrazovky -tržiště se prodává se snímky obrazovky. Přetáhněte několik PNGů do -`public/gallery/` a odkazujte na ně `screenshots` — vykreslují se jako galerie -na stránce seznamu. +tržiště se prodává se snímky obrazovky. Vložte několik souborů PNG do +`public/gallery/` a odkažte se na ně pomocí `galleryImages` — na stránce s výpisem se zobrazí jako +galerie v pořadí, v jakém jsou v poli. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/de/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/de/developers/extend/apps/config/application.mdx index 5ffd3eee7d..1b821f4237 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ Wenn Sie planen, [Ihre App zu veröffentlichen](/l/de/developers/extend/apps/ope | ------------------ | ------------------------------------------------------------------------------------------------------------------------------- | | `author` | Name des Autors oder des Unternehmens | | `category` | App-Kategorie für die Filterung im Marktplatz | -| `logoUrl` | Pfad zu Ihrem App-Logo (z. B. `public/logo.png`) | -| `screenshots` | Array von Screenshot-Pfaden (z. B. `public/screenshot-1.png`) | +| `logo` | Pfad zu deinem App-Logo in `public/` gebündelt (z.B. `public/logo.png`) | +| `galleryImages` | Array der Galerie-Bild-Pfade in `public/` gebündelt (z.B. `public/screenshot-1.png`) | | `aboutDescription` | Längere Markdown-Beschreibung für den Tab "Info". Wenn weggelassen, verwendet der Marktplatz die `README.md` des Pakets von npm | | `websiteUrl` | Link zu Ihrer Website | | `termsUrl` | Link zu den Nutzungsbedingungen | | `emailSupport` | Support-E-Mail-Adresse | | `issueReportUrl` | Link zum Issue-Tracker | + + +`logoUrl` und `screenshots` sind veraltete Aliase von `logo` und `galleryImages`. Externe absolute URLs (`http://` oder `https://`) werden für diese Felder nicht unterstützt: Sie werden beim Build mit einer Warnung gelöscht. Bundle stattdessen die Bilder im `public/` Ordner deiner App. + diff --git a/packages/twenty-docs/l/de/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/de/developers/extend/apps/config/public-assets.mdx index 822240a70a..9e30ed2e6f 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ Für Dateien im Verzeichnis `public/` gilt: * **Öffentlich zugänglich** — nach der Synchronisierung mit dem Server werden Assets unter einer öffentlichen URL bereitgestellt. Zum Zugriff ist keine Authentifizierung erforderlich. * **In Frontend-Komponenten verfügbar** — verwenden Sie Asset-URLs, um Bilder, Icons oder andere Medien in Ihren React-Komponenten anzuzeigen. * **In Logikfunktionen verfügbar** — referenzieren Sie Asset-URLs in E-Mails, API-Antworten oder in beliebiger serverseitiger Logik. -* **Für Marketplace-Metadaten verwendet** — die Felder `logoUrl` und `screenshots` in `defineApplication()` referenzieren Dateien aus diesem Ordner (z. B. `public/logo.png`). Diese werden im Marketplace angezeigt, wenn Ihre App veröffentlicht wird. +* \*\*Für Marketplace Metadaten \*\* — die Felder `logo` und `galleryImages` in `defineApplication()` Referenzdateien aus diesem Ordner (z. B. `public/logo.png`). Diese werden im Marketplace angezeigt, wenn Ihre App veröffentlicht wird. Externe absolute URLs werden für diese Felder ignoriert — bündeln Sie stattdessen die Bilder in `public/`. * **Im Dev-Modus automatisch synchronisiert** — wenn Sie in `public/` eine Datei hinzufügen, aktualisieren oder löschen, wird sie automatisch mit dem Server synchronisiert. Kein Neustart erforderlich. * **In Builds enthalten** — `yarn twenty dev:build` bündelt alle öffentlichen Assets in der Distributionsausgabe. diff --git a/packages/twenty-docs/l/de/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/de/developers/extend/apps/getting-started/project-structure.mdx index 51d20279e3..d1ff1ab877 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## Wichtige Dateien @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | Ein Unit-Test plus ein Integrationstest (mit seinem globalen Setup), der die App mit einem echten Server synchronisiert. | | `public/` | Statische Assets (Bilder, Schriftarten), die mit Ihrer App ausgeliefert werden. | | `AGENTS.md` / `CLAUDE.md` | Leitfaden für KI-Coding-Agenten, die an der App arbeiten. | +| `CHANGELOG.md` / `SETUP.md` | Changelog mit wichtigen Änderungen und Einrichtungsanweisungen für die lokale Entwicklung. | **Die Dateiorganisation liegt bei Ihnen.** Die oben genannten Ordner sind Konventionen – das SDK erkennt Entitäten über eine AST-Analyse von `export default defineEntity(...)`-Aufrufen, unabhängig davon, wo sich die Datei befindet. diff --git a/packages/twenty-docs/l/de/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/de/developers/extend/apps/operations/publishing.mdx index 884be8af2b..3ac496d2fe 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ Die Veröffentlichung auf npm macht Ihre App im Twenty-Marktplatz auffindbar. Je ### Marktplatz-Metadaten -Die `defineApplication()`-Konfiguration unterstützt optionale Felder, die steuern, wie Ihre App im Marktplatz erscheint. Verwenden Sie `logoUrl` und `screenshots`, um Bilder aus dem Ordner `public/` zu referenzieren: +Die `defineApplication()`-Konfiguration unterstützt optionale Felder, die steuern, wie Ihre App im Marktplatz erscheint. Verwende `logo` und `galleryImages` um Bilder aus dem `public/` Ordner zu referenzieren: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ Siehe das [defineApplication-Akkordeon](/l/de/developers/extend/apps/config/application#marketplace-metadata) auf der Seite Building Apps für die vollständige Liste der Marktplatzfelder (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl` usw.). -#### Empfohlene Abmessungen für Screenshots +#### Empfohlene Galerieabmessungen -Der Marktplatz stellt `screenshots` in einem festen `8:5`-Container dar (zum Beispiel `1600×1000 px`). +Der Marktplatz zeigt `galleryImages` in einem fixen `8:5` Container an (z.B. `1600×1000 px`). -Screenshots mit beliebigem Seitenverhältnis werden vollständig angezeigt und niemals beschnitten, aber alles, was deutlich höher oder schmaler als `8:5` ist, zeigt an den Seiten leere Balken. +Galeriebilder mit beliebigem Seitenverhältnis werden vollständig angezeigt und werden nie zugeschnitten, aber irgendetwas wesentlich höher oder enger als `8:5` wird leere Bands auf den Seiten zeigen. ### Veröffentlichen diff --git a/packages/twenty-docs/l/de/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/de/developers/extend/apps/tutorials/document-generator/publishing.mdx index 786a40bb34..a23d9e6cdf 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ Ihre App funktioniert. Der letzte Schritt ist, es für den Marktplatz zu beschre Die [Anwendung config](/l/de/developers/extend/apps/config/application) trägt die Identität, die im Marktplatz erscheint: Autor, Kategorie, Logo und Unterstützung von -Links. Lege ein Logo in `public/` ein und verweise es mit `logoUrl`. +Links. Lege ein Logo in `public/` ein und verweise es mit `logo`. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/de/developers/extend/apps', @@ -43,14 +43,14 @@ Füge auch das Schlüsselwort "twenty-app" zu "package.json" hinzu, damit die Ap ## Galerie Screenshots hinzufügen -Ein Marktplatz-Listing verkauft sich mit Screenshots. Legen Sie ein paar PNGs in -`public/gallery/` und verweisen Sie sie mit `screenshots` — sie rendern als Galerie -auf der Listenseite. +Ein Marktplatz-Listing verkauft sich mit Screenshots. Lege ein paar PNGs in +`public/gallery/` und verweise sie mit `galleryImages` — sie rendern als +Galerie auf der Listenseite, in Array-Reihenfolge. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx index bd280578ec..bf4320b112 100644 --- a/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/es/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ Si planeas [publicar tu aplicación](/l/es/developers/extend/apps/operations/pub | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | `author` | Nombre del autor o de la empresa | | `category` | Categoría de la aplicación para el filtrado en el marketplace | -| `logoUrl` | Ruta al logotipo de tu aplicación (p. ej., `public/logo.png`) | -| `screenshots` | Arreglo de rutas de capturas de pantalla (p. ej., `public/screenshot-1.png`) | +| `logo` | Ruta al logotipo de tu aplicación incluido en `public/` (p. ej., `public/logo.png`) | +| `galleryImages` | Arreglo de rutas de imágenes de galería incluidas en `public/` (p. ej., `public/screenshot-1.png`) | | `aboutDescription` | Descripción en Markdown más extensa para la pestaña "Acerca de". Si se omite, el marketplace utiliza el `README.md` del paquete en npm | | `websiteUrl` | Enlace a tu sitio web | | `termsUrl` | Enlace a los términos del servicio | | `emailSupport` | Dirección de correo electrónico de soporte | | `issueReportUrl` | Enlace al rastreador de incidencias | + + +`logoUrl` y `screenshots` son alias obsoletos de `logo` y `galleryImages`. Las URL absolutas externas (`http://` o `https://`) no son compatibles para estos campos: se descartan con una advertencia en tiempo de compilación. En su lugar, incluye las imágenes en la carpeta `public/` de tu aplicación. + diff --git a/packages/twenty-docs/l/es/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/es/developers/extend/apps/config/public-assets.mdx index b9f81d11ec..62f981c922 100644 --- a/packages/twenty-docs/l/es/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/es/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ Los archivos ubicados en `public/` son: * **De acceso público** — una vez sincronizados con el servidor, los recursos se sirven en una URL pública. No se necesita autenticación para acceder a ellos. * **Disponibles en componentes de frontend** — usa las URLs de los recursos para mostrar imágenes, íconos o cualquier medio dentro de tus componentes de React. * **Disponibles en funciones de lógica** — referencia las URLs de los recursos en correos electrónicos, respuestas de API o cualquier lógica del lado del servidor. -* **Usados para metadatos del marketplace** — los campos `logoUrl` y `screenshots` en `defineApplication()` referencian archivos de esta carpeta (p. ej., `public/logo.png`). Estos se muestran en el marketplace cuando se publica tu aplicación. +* **Usados para metadatos del marketplace** — los campos `logo` y `galleryImages` en `defineApplication()` referencian archivos de esta carpeta (p. ej., `public/logo.png`). Estos se muestran en el marketplace cuando se publica tu aplicación. Las URL absolutas externas se omiten para estos campos; en su lugar, incluye las imágenes en `public/`. * **Sincronizados automáticamente en modo de desarrollo** — cuando agregas, actualizas o eliminas un archivo en `public/`, se sincroniza automáticamente con el servidor. No se necesita reiniciar. * **Incluidos en las compilaciones** — `yarn twenty dev:build` agrupa todos los recursos públicos en la salida de distribución. diff --git a/packages/twenty-docs/l/es/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/project-structure.mdx index b5a0b74465..c558d32ded 100644 --- a/packages/twenty-docs/l/es/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/es/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## Archivos clave @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | Una prueba unitaria más una prueba de integración (con su configuración global) que sincroniza la aplicación contra un servidor real. | | `public/` | Recursos estáticos (imágenes, fuentes) servidos con tu app. | | `AGENTS.md` / `CLAUDE.md` | Guía para agentes de IA para programación que trabajan en la aplicación. | +| `CHANGELOG.md` / `SETUP.md` | Registro de cambios destacados e instrucciones de configuración para el desarrollo local. | **La organización de archivos depende de ti.** Las carpetas anteriores son convenciones: el SDK detecta entidades mediante análisis AST en llamadas a `export default defineEntity(...)`, sin importar dónde se encuentre el archivo. diff --git a/packages/twenty-docs/l/es/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/es/developers/extend/apps/operations/publishing.mdx index 8924f6a7c9..8589c08a7f 100644 --- a/packages/twenty-docs/l/es/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/es/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ Publicarla en npm hace que tu aplicación sea visible en el marketplace de Twent ### Metadatos del Marketplace -La configuración de `defineApplication()` admite campos opcionales que controlan cómo aparece tu aplicación en el marketplace. Usa `logoUrl` y `screenshots` para hacer referencia a imágenes de la carpeta `public/`: +La configuración de `defineApplication()` admite campos opcionales que controlan cómo aparece tu aplicación en el marketplace. Usa `logo` y `galleryImages` para hacer referencia a imágenes de la carpeta `public/`: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ Consulta el [acordeón de defineApplication](/l/es/developers/extend/apps/config/application#marketplace-metadata) en la página Building Apps para ver la lista completa de campos del marketplace (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, etc.). -#### Dimensiones recomendadas de las capturas de pantalla +#### Dimensiones recomendadas de las imágenes de la galería -El marketplace muestra `screenshots` en un contenedor fijo de `8:5` (por ejemplo, `1600×1000 px`). +El marketplace muestra `galleryImages` en un contenedor fijo de `8:5` (por ejemplo, `1600×1000 px`). -Las capturas de pantalla de cualquier relación de aspecto se muestran completas y nunca se recortan, pero las que sean significativamente más altas o más estrechas que `8:5` mostrarán franjas vacías a los lados. +Las imágenes de la galería de cualquier relación de aspecto se muestran completas y nunca se recortan, pero las que sean significativamente más altas o más estrechas que `8:5` mostrarán franjas vacías a los lados. ### Publicar diff --git a/packages/twenty-docs/l/es/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/es/developers/extend/apps/tutorials/document-generator/publishing.mdx index 8381f52926..996ba1e829 100644 --- a/packages/twenty-docs/l/es/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/es/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ Tu app funciona. El último paso es describirlo para el mercado y publicarlo. La [configuración de la aplicación](/l/es/developers/extend/apps/config/application) lleva los enlaces que se muestran en el mercado: autor, categoría, logotipo y soporte -. Pon un logotipo en `public/` y referencialo con `logoUrl`. +. Coloca un logotipo en `public/` y haz referencia a él con `logo`. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/es/developers/extend/apps', @@ -43,14 +43,12 @@ También añade la palabra clave `twenty-app` a `package.json` para que la aplic ## Añadir capturas de pantalla de galería -Un listado de mercado se vende a sí mismo con capturas de pantalla. Soltar unos pocos PNGs en -`public/gallery/` y referenciarlos con `capturas de pantalla` — se renderizan como una galería -en la página de listado. +Un listado de mercado se vende a sí mismo con capturas de pantalla. Coloca algunos PNG en `public/gallery/` y haz referencia a ellos con `galleryImages` — se muestran como una galería en la página de listado, en el orden del array. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/config/application.mdx index 35486c5d44..4d08dcc063 100644 --- a/packages/twenty-docs/l/fr/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/fr/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ Si vous prévoyez de [publier votre application](/l/fr/developers/extend/apps/op | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | | `author` | Nom de l'auteur ou de l'entreprise | | `category` | Catégorie de l'application pour le filtrage dans la marketplace | -| `logoUrl` | Chemin vers le logo de votre application (p. ex., `public/logo.png`) | -| `screenshots` | Tableau de chemins de captures d'écran (p. ex., `public/screenshot-1.png`) | +| `logo` | Chemin vers le logo de votre application empaqueté dans `public/` (p. ex., `public/logo.png`) | +| `galleryImages` | Tableau de chemins d’images de galerie empaquetées dans `public/` (p. ex., `public/screenshot-1.png`) | | `aboutDescription` | Description markdown plus longue pour l'onglet "À propos". S'il est omis, la marketplace utilise le `README.md` du package sur npm | | `websiteUrl` | Lien vers votre site web | | `termsUrl` | Lien vers les conditions d'utilisation | | `emailSupport` | Adresse e-mail du support | | `issueReportUrl` | Lien vers le système de suivi des problèmes | + + +`logoUrl` et `screenshots` sont des alias obsolètes de `logo` et `galleryImages`. Les URL absolues externes (`http://` ou `https://`) ne sont pas prises en charge pour ces champs : elles sont ignorées avec un avertissement au moment de la compilation. Placez plutôt les images dans le dossier `public/` de votre application. + diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/config/public-assets.mdx index a4e76426f9..7638da7d27 100644 --- a/packages/twenty-docs/l/fr/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/fr/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ Les fichiers placés dans `public/` sont : * **Accessibles publiquement** — une fois synchronisés avec le serveur, les fichiers sont servis à une URL publique. Aucune authentification n'est nécessaire pour y accéder. * **Disponibles dans les composants frontaux** — utilisez les URL des ressources pour afficher des images, des icônes ou tout média dans vos composants React. * **Disponibles dans les fonctions logiques** — référencez des URL de ressources dans des e-mails, des réponses d'API ou toute logique côté serveur. -* **Utilisés pour les métadonnées de marketplace** — les champs `logoUrl` et `screenshots` dans `defineApplication()` référencent des fichiers de ce dossier (p. ex., `public/logo.png`). Celles-ci sont affichées dans la marketplace lorsque votre application est publiée. +* **Utilisés pour les métadonnées de marketplace** — les champs `logo` et `galleryImages` dans `defineApplication()` référencent des fichiers de ce dossier (p. ex., `public/logo.png`). Celles-ci sont affichées dans la marketplace lorsque votre application est publiée. Les URL absolues externes sont ignorées pour ces champs — intégrez plutôt les images dans `public/`. * **Synchronisés automatiquement en mode dev** — lorsque vous ajoutez, mettez à jour ou supprimez un fichier dans `public/`, il est automatiquement synchronisé avec le serveur. Aucun redémarrage nécessaire. * **Inclus dans les builds** — `yarn twenty dev:build` regroupe toutes les ressources publiques dans la sortie de distribution. diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/project-structure.mdx index 62b4403e62..e3ee1cceb7 100644 --- a/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/fr/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## Fichiers clés @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | Un test unitaire plus un test d’intégration (avec sa configuration globale) qui synchronise l’application avec un serveur réel. | | `public/` | Ressources statiques (images, polices) servies avec votre application. | | `AGENTS.md` / `CLAUDE.md` | Consignes pour les agents IA de programmation travaillant sur l’application. | +| `CHANGELOG.md` / `SETUP.md` | Journal des modifications notables et instructions de configuration pour le développement local. | **L’organisation des fichiers vous revient.** Les dossiers ci-dessus sont des conventions — le SDK détecte les entités via une analyse AST sur les appels à `export default defineEntity(...)` quel que soit l’emplacement du fichier. diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/operations/publishing.mdx index 8b0b603777..9b7c5d5bcf 100644 --- a/packages/twenty-docs/l/fr/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/fr/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ Publier sur npm rend votre application découvrable dans la marketplace Twenty. ### Métadonnées de la marketplace -La configuration `defineApplication()` prend en charge des champs optionnels qui contrôlent la façon dont votre application apparaît sur la place de marché. Utilisez `logoUrl` et `screenshots` pour référencer des images depuis le dossier `public/` : +La configuration `defineApplication()` prend en charge des champs optionnels qui contrôlent la façon dont votre application apparaît sur la place de marché. Utilisez `logo` et `galleryImages` pour référencer des images depuis le dossier `public/` : ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ Voir l'[accordéon defineApplication](/l/fr/developers/extend/apps/config/application#marketplace-metadata) dans la page Building Apps pour la liste complète des champs de la place de marché (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, etc.). -#### Dimensions recommandées pour les captures d'écran +#### Dimensions recommandées pour les images de la galerie -La place de marché affiche `screenshots` dans un conteneur fixe `8:5` (par exemple, `1600×1000 px`). +La place de marché affiche `galleryImages` dans un conteneur fixe `8:5` (par exemple, `1600×1000 px`). -Les captures d'écran, quel que soit leur ratio d'aspect, sont affichées en entier et ne sont jamais recadrées, mais tout ce qui est nettement plus haut ou plus étroit que `8:5` affichera des bandes vides sur les côtés. +Les images de la galerie, quel que soit leur ratio d'aspect, sont affichées en entier et ne sont jamais recadrées, mais tout ce qui est nettement plus haut ou plus étroit que `8:5` affichera des bandes vides sur les côtés. ### Publier diff --git a/packages/twenty-docs/l/fr/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/fr/developers/extend/apps/tutorials/document-generator/publishing.mdx index b4ab797a46..9cb7536e06 100644 --- a/packages/twenty-docs/l/fr/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/fr/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ Votre application fonctionne. La dernière étape consiste à la décrire pour l La [configuration de l'application](/l/fr/developers/extend/apps/config/application) porte l'identité qui apparaît sur le marché : auteur, catégorie, logo et liens de support -. Mettez un logo dans `public/` et faites-le référence avec `logoUrl`. +. Placez un logo dans `public/` et référencez-le avec `logo`. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/fr/developers/extend/apps', @@ -43,14 +43,14 @@ Ajoute également le mot-clé `21app` à `package.json` pour que l'application s ## Ajouter des captures d'écran de la galerie -Une annonce boursière se vend avec des captures d'écran. Déposez quelques PNGs dans -`public/gallery/` et référencez-les avec `screenshots` — ils apparaissent comme une galerie -sur la page de liste. +Une annonce boursière se vend avec des captures d'écran. Déposez quelques PNG dans +`public/gallery/` et référencez-les avec `galleryImages` — ils sont affichés comme une +galerie sur la page de l’annonce, dans l’ordre du tableau. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx index 3c0b3ede47..4d92ba9b54 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ Se prevedi di [pubblicare la tua app](/l/it/developers/extend/apps/operations/pu | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | | `author` | Nome dell'autore o dell'azienda | | `category` | Categoria dell'app per il filtraggio nel marketplace | -| `logoUrl` | Percorso del logo della tua app (ad es., `public/logo.png`) | -| `screenshots` | Array di percorsi degli screenshot (ad es., `public/screenshot-1.png`) | +| `logo` | Percorso del logo dell'app in bundle in `public/` (ad esempio, `public/logo.png`) | +| `galleryImages` | Array dei percorsi delle immagini della galleria raggruppati in `public/` (ad esempio, `public/screenshot-1.png`) | | `aboutDescription` | Descrizione markdown più lunga per la scheda "Informazioni". Se omesso, il marketplace utilizza il `README.md` del pacchetto da npm | | `websiteUrl` | Link al tuo sito web | | `termsUrl` | Link ai Termini di servizio | | `emailSupport` | Indirizzo email di supporto | | `issueReportUrl` | Link al sistema di tracciamento dei problemi | + + +`logoUrl` e `screenshots` sono alias deprecati di `logo` e `galleryImages`. Gli URL assoluti esterni (`http://` o `https://`) non sono supportati per questi campi: vengono eliminati con un avviso al momento della generazione. Raccogli invece le immagini nella cartella `public/` della tua app. + diff --git a/packages/twenty-docs/l/it/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/it/developers/extend/apps/config/public-assets.mdx index dbdc0ca919..4c66dfc51c 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ I file posizionati in `public/` sono: * **Pubblicamente accessibili** — una volta sincronizzati sul server, gli asset sono serviti a un URL pubblico. Non è necessaria alcuna autenticazione per accedervi. * **Disponibili nei componenti front-end** — usa gli URL degli asset per visualizzare immagini, icone o qualsiasi media all'interno dei tuoi componenti React. * **Disponibili nelle funzioni logiche** — fai riferimento agli URL degli asset nelle email, nelle risposte API o in qualsiasi logica lato server. -* **Usati per i metadati del marketplace** — i campi `logoUrl` e `screenshots` in `defineApplication()` fanno riferimento a file di questa cartella (ad es., `public/logo.png`). Questi vengono visualizzati nel marketplace quando la tua app viene pubblicata. +* **Utilizzato per i metadati di mercato** — i campi `logo` e `galleryImages` nei file di riferimento `defineApplication()` di questa cartella (ad esempio, `public/logo.png`). Questi vengono visualizzati nel marketplace quando la tua app viene pubblicata. Gli URL assoluti esterni vengono ignorati per questi campi — raggruppano invece le immagini in `public/`. * **Sincronizzati automaticamente in modalità dev** — quando aggiungi, aggiorni o elimini un file in `public/`, viene sincronizzato automaticamente con il server. Nessun riavvio necessario. * **Inclusi nelle build** — `yarn twenty dev:build` raggruppa tutti gli asset pubblici nell'output di distribuzione. diff --git a/packages/twenty-docs/l/it/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/project-structure.mdx index b8381cec7a..251607e1ac 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## File principali @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | Un test unitario più un test di integrazione (con il relativo setup globale) che sincronizza l'app con un server reale. | | `public/` | Asset statici (immagini, font) serviti insieme alla tua app. | | `AGENTS.md` / `CLAUDE.md` | Linee guida per gli agenti di codice AI che lavorano sull'app. | +| `CHANGELOG.md` / `SETUP.md` | Changelog delle modifiche importanti e istruzioni di configurazione per lo sviluppo locale. | **L'organizzazione dei file dipende da te.** Le cartelle sopra sono convenzioni — l'SDK rileva le entità tramite analisi AST sulle chiamate a `export default defineEntity(...)` indipendentemente da dove si trova il file. diff --git a/packages/twenty-docs/l/it/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/it/developers/extend/apps/operations/publishing.mdx index c09d9bf218..1ca167efde 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ La pubblicazione su npm rende la tua app scopribile nel marketplace di Twenty. Q ### Metadati del marketplace -La configurazione `defineApplication()` supporta campi opzionali che controllano come la tua app appare nel marketplace. Usa `logoUrl` e `screenshots` per fare riferimento alle immagini nella cartella `public/`: +La configurazione `defineApplication()` supporta campi opzionali che controllano come la tua app appare nel marketplace. Usa `logo` e `galleryImages` per fare riferimento alle immagini nella cartella `public/`: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ Vedi l'[accordion defineApplication](/l/it/developers/extend/apps/config/application#marketplace-metadata) nella pagina Building Apps per l'elenco completo dei campi del marketplace (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, ecc.). -#### Dimensioni consigliate degli screenshot +#### Dimensioni consigliate delle immagini della galleria -Il marketplace visualizza gli `screenshots` in un contenitore `8:5` fisso (ad esempio, `1600×1000 px`). +Il marketplace visualizza le `galleryImages` in un contenitore `8:5` fisso (ad esempio, `1600×1000 px`). -Gli screenshot di qualsiasi rapporto d'aspetto vengono visualizzati per intero e non vengono mai ritagliati, ma tutto ciò che è significativamente più alto o più stretto di `8:5` mostrerà bande vuote ai lati. +Le immagini della galleria di qualsiasi rapporto d'aspetto vengono visualizzate per intero e non vengono mai ritagliate, ma tutto ciò che è significativamente più alto o più stretto di `8:5` mostrerà bande vuote ai lati. ### Pubblica diff --git a/packages/twenty-docs/l/it/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/it/developers/extend/apps/tutorials/document-generator/publishing.mdx index cab31df02a..debcd7fa52 100644 --- a/packages/twenty-docs/l/it/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/it/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ La tua app funziona. L'ultimo passo è descriverlo per il mercato e pubblicarlo. La [application config](/l/it/developers/extend/apps/config/application) contiene l'identità che appare nel marketplace: autore, categoria, logo e supporta i link -. Metti un logo in `public/` e fai riferimento con `logoUrl`. +. Metti un logo in `public/` e fai riferimento con `logo`. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/it/developers/extend/apps', @@ -42,14 +42,14 @@ Aggiungi anche la parola chiave `twenty-app` a `package.json` così l'app è sco ## Aggiungi screenshot galleria -Una quotazione di mercato si vende con screenshot. Trascina alcuni PNG nella `public/gallery/` di -e li referenzia con `screenshots` — sono una galleria -nella pagina di inserimento. +Una quotazione di mercato si vende con screenshot. Trascina alcuni PNG in `public/gallery/` di +e li referenzia con `galleryImages` — rendono come una galleria +nella pagina di elenco, in ordine array. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/config/application.mdx index 839034a9fd..f0f1662005 100644 --- a/packages/twenty-docs/l/ja/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/ja/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ const config = JSON.parse(process.env.PROVIDER_CONFIG ?? '{}'); // '{"retries":3 | ------------------ | -------------------------------------------------------------------------------- | | `author` | 作成者または会社名 | | `category` | マーケットプレイスのフィルタリング用のアプリカテゴリ | -| `logoUrl` | アプリのロゴへのパス（例：`public/logo.png`） | -| `screenshots` | スクリーンショットのパス配列（例：`public/screenshot-1.png`） | +| `logo` | `public/`にバンドルされているアプリのロゴのパス（例：`public/logo.png`） | +| `galleryImages` | `public/`にバンドルされているギャラリー画像パスの配列（例：`public/screenshot-1.png`） | | `aboutDescription` | 「About」タブ向けの詳細な Markdown 説明。 省略した場合、マーケットプレイスは npm のパッケージにある `README.md` を使用します。 | | `websiteUrl` | 自社ウェブサイトへのリンク | | `termsUrl` | 利用規約へのリンク | | `emailSupport` | サポート用メールアドレス | | `issueReportUrl` | 課題トラッカーへのリンク | + + +`logoUrl`と`screenshots`は、`logo`と`galleryImages`の別名は非推奨です。 外部絶対URL (`http://`または`https://`) はこれらのフィールドでサポートされていません: ビルド時に警告が表示されます。 アプリの `public/` フォルダに画像を束ねます。 + diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/config/public-assets.mdx index 3d6b6dad26..2024b46f6b 100644 --- a/packages/twenty-docs/l/ja/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/ja/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ icon: folder-open * **公開アクセス可能** — サーバーに同期されると、アセットはパブリック URL で配信されます。 アクセスには認証は不要です。 * **フロントコンポーネントで利用可能** — アセットの URL を使用して、React コンポーネント内に画像、アイコン、その他のメディアを表示します。 * **ロジック関数で利用可能** — メール、API レスポンス、その他のサーバーサイドロジックでアセットの URL を参照します。 -* **マーケットプレイスのメタデータに使用** — `defineApplication()` の `logoUrl` と `screenshots` フィールドは、このフォルダー内のファイルを参照します（例：`public/logo.png`）。 アプリを公開すると、これらがマーケットプレイスに表示されます。 +* **マーケットプレイスのメタデータに使用** — `logo`と`galleryImages`フィールドの`defineApplication()`参照ファイルのこのフォルダ（例：`public/logo.png`）。 アプリを公開すると、これらがマーケットプレイスに表示されます。 外部の絶対URLはこれらのフィールドでは無視されます — 代わりに`public/`で画像をバンドルします。 * **開発モードで自動同期** — `public/` のファイルを追加、更新、削除すると、自動的にサーバーへ同期されます。 再起動は不要です。 * **ビルドに含まれる** — `yarn twenty dev:build` はすべての公開アセットを配布物にバンドルします。 diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/getting-started/project-structure.mdx index a768898150..36f77dcc9c 100644 --- a/packages/twenty-docs/l/ja/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/ja/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## 主要ファイル @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | ユニットテストと、（グローバルセットアップ付きで）実際のサーバーに対してアプリを同期する統合テスト。 | | `public/` | アプリとともに提供される静的アセット（画像、フォント）。 | | `AGENTS.md` / `CLAUDE.md` | アプリ上で作業する AI コーディングエージェント向けのガイダンス。 | +| `CHANGELOG.md` / `SETUP.md` | 主な変更の履歴とローカル開発用のセットアップ手順。 | **ファイル構成は自由です。** 上記のフォルダーはあくまで慣習であり、SDK はファイルがどこにあっても、`export default defineEntity(...)` 呼び出しに対する AST 解析によってエンティティを検出します。 diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/operations/publishing.mdx index b34b3d24d5..70776752b3 100644 --- a/packages/twenty-docs/l/ja/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/ja/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ npm に公開すると、Twenty マーケットプレイスでアプリが見つ ### マーケットプレイスのメタデータ -`defineApplication()` の設定は、マーケットプレイスでのアプリの表示方法を制御する任意のフィールドをサポートします。 `public/` フォルダー内の画像を参照するには、`logoUrl` と `screenshots` を使用します: +`defineApplication()` の設定は、マーケットプレイスでのアプリの表示方法を制御する任意のフィールドをサポートします。 `public/` フォルダー内の画像を参照するには、`logo` と `galleryImages` を使用します: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ マーケットプレイスのフィールド（`author`、`category`、`aboutDescription`、`websiteUrl`、`termsUrl` など）の完全な一覧は、Building Apps ページの[defineApplication アコーディオン](/l/ja/developers/extend/apps/config/application#marketplace-metadata)を参照してください。 -#### 推奨されるスクリーンショットのサイズ +#### 推奨されるギャラリー画像のサイズ -マーケットプレイスでは、`screenshots` は固定の `8:5` コンテナ内で表示されます（例：`1600×1000 px`）。 +マーケットプレイスでは、`galleryImages` は固定の `8:5` コンテナ内で表示されます（例：`1600×1000 px`）。 -どのようなアスペクト比でもスクリーンショットは全体が表示され、トリミングされることはありません。ただし、`8:5` よりも著しく縦長または横長の場合は、上下または左右に空白の帯が表示されます。 +どのようなアスペクト比でもギャラリー画像は全体が表示され、トリミングされることはありません。ただし、`8:5` よりも著しく縦長の場合は、左右に空白の帯が表示されます。 ### 公開 diff --git a/packages/twenty-docs/l/ja/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/ja/developers/extend/apps/tutorials/document-generator/publishing.mdx index 4a14214df9..982fd1dff9 100644 --- a/packages/twenty-docs/l/ja/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/ja/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ description: マーケットプレイスのメタデータを追加し、アプ [アプリケーション config](/l/ja/developers/extend/apps/config/application) は、マーケットプレイスに表示される アイデンティティを持ちます。これは、作成者、カテゴリ、ロゴ、サポート -リンクです。 `public/`にロゴを入れ、`logoUrl`で参照してください。 +リンクです。 `public/`にロゴを入れて、`logo`で参照してください。 ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/ja/developers/extend/apps', @@ -43,13 +43,13 @@ export default defineApplication({ ## ギャラリースクリーンショットを追加 マーケットプレイスのリストはスクリーンショットで自分自身を販売します。 -`public/gallery/` にPNGをいくつかドロップして、`screenshots` を使って参照します。リストページでギャラリー -としてレンダリングします。 +`public/gallery/`にPNGをいくつかドロップし、`galleryImages`で参照します。リストページの +ギャラリーとして表示されます。 行列の順序で入力します。 ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx index b721a0b129..552a54dc45 100644 --- a/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/ko/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ const config = JSON.parse(process.env.PROVIDER_CONFIG ?? '{}'); // '{"retries":3 | ------------------ | ------------------------------------------------------------------- | | `author` | 작성자 또는 회사 이름 | | `category` | 마켓플레이스 필터링을 위한 앱 카테고리 | -| `logoUrl` | 앱 로고의 경로(예: `public/logo.png`) | -| `screenshots` | 스크린샷 경로의 배열(예: `public/screenshot-1.png`) | +| `logo` | 앱 로고가 번들된 `public/`의 경로(예: `public/logo.png`) | +| `galleryImages` | 갤러리 이미지 경로 배열이 `public/`에 번들됨(예: `public/screenshot-1.png`) | | `aboutDescription` | "About" 탭에 대한 더 긴 마크다운 설명. 생략하면 마켓플레이스는 npm의 패키지 `README.md`를 사용합니다 | | `websiteUrl` | 웹사이트 링크 | | `termsUrl` | 서비스 약관 링크 | | `emailSupport` | 지원 이메일 주소 | | `issueReportUrl` | 이슈 트래커 링크 | + + +`logoUrl` 및 `screenshots`는 `logo` 및 `galleryImages`의 더 이상 사용되지 않는 별칭입니다. 다음 필드에는 외부 절대 URL(`http://` 또는 `https://`)이 지원되지 않습니다. 빌드 시 경고와 함께 제거됩니다. 대신 앱의 `public/` 폴더에 이미지를 번들하세요. + diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/config/public-assets.mdx index f3f02152db..cb58fc64ba 100644 --- a/packages/twenty-docs/l/ko/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/ko/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ icon: folder-open * **공개적으로 접근 가능** — 서버로 동기화되면 에셋은 공개 URL로 제공됩니다. 접근하려면 인증이 필요하지 않습니다. * **프런트 컴포넌트에서 사용 가능** — React 컴포넌트 내부에서 이미지, 아이콘 또는 미디어를 표시하기 위해 에셋 URL을 사용하세요. * **로직 함수에서 사용 가능** — 이메일, API 응답 또는 서버 측 로직에서 에셋 URL을 참조하세요. -* **마켓플레이스 메타데이터에 사용** — `defineApplication()`의 `logoUrl` 및 `screenshots` 필드는 이 폴더의 파일을 참조합니다(예: `public/logo.png`). 앱이 게시되면 이러한 항목이 마켓플레이스에 표시됩니다. +* **마켓플레이스 메타데이터에 사용** — `defineApplication()`의 `logo` 및 `galleryImages` 필드는 이 폴더의 파일을 참조합니다(예: `public/logo.png`). 앱이 게시되면 이러한 항목이 마켓플레이스에 표시됩니다. 이 필드에서 외부 절대 URL은 무시되므로, 대신 이미지를 `public/` 폴더에 번들링하세요. * **개발 모드에서 자동 동기화** — `public/`에 파일을 추가, 업데이트 또는 삭제하면 자동으로 서버와 동기화됩니다. 재시작이 필요 없습니다. * **빌드에 포함** — `yarn twenty dev:build`는 모든 퍼블릭 에셋을 배포 출력물에 번들합니다. diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/project-structure.mdx index 26777abcec..f3f7915378 100644 --- a/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/ko/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## 주요 파일 @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | 실제 서버와 앱을 동기화하는 통합 테스트(글로벌 설정 포함)와 단위 테스트입니다. | | `public/` | 앱과 함께 제공되는 정적 에셋(이미지, 폰트). | | `AGENTS.md` / `CLAUDE.md` | 앱에서 작업하는 AI 코딩 에이전트를 위한 안내서입니다. | +| `CHANGELOG.md` / `SETUP.md` | 주요 변경 로그와 로컬 개발을 위한 설정 지침입니다. | **파일 구성은 사용자의 선택입니다.** 위 폴더들은 관례일 뿐이며, SDK는 파일 위치와 관계없이 `export default defineEntity(...)` 호출에 대한 AST 분석을 통해 엔티티를 감지합니다. diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/operations/publishing.mdx index f31de0fa0e..bb80690f8a 100644 --- a/packages/twenty-docs/l/ko/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/ko/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ npm에 게시하면 Twenty 마켓플레이스에서 앱을 찾을 수 있게 됩 ### 마켓플레이스 메타데이터 -`defineApplication()` 구성은 마켓플레이스에서 앱이 표시되는 방식을 제어하는 선택적 필드를 지원합니다. `public/` 폴더의 이미지를 참조하려면 `logoUrl`과 `screenshots`를 사용하세요: +`defineApplication()` 구성은 마켓플레이스에서 앱이 표시되는 방식을 제어하는 선택적 필드를 지원합니다. `public/` 폴더의 이미지를 참조하려면 `logo`와 `galleryImages`를 사용하세요: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ 마켓플레이스 필드 전체 목록(`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl` 등)은 Building Apps 페이지의 [defineApplication 아코디언](/l/ko/developers/extend/apps/config/application#marketplace-metadata)을 참조하세요. -#### 권장 스크린샷 크기 +#### 권장 갤러리 이미지 크기 -마켓플레이스는 `screenshots`를 고정된 `8:5` 컨테이너에 렌더링합니다(예: `1600×1000 px`). +마켓플레이스는 `galleryImages`를 고정된 `8:5` 컨테이너에 렌더링합니다(예: `1600×1000 px`). -어떤 종횡비의 스크린샷이든 전체가 표시되며 잘리지 않습니다. 그러나 `8:5`보다 훨씬 세로로 길거나 가로로 좁은 경우 양쪽에 빈 띠가 표시됩니다. +어떤 종횡비의 갤러리 이미지든 전체가 표시되며 잘리지 않습니다. 그러나 `8:5`보다 훨씬 세로로 길거나 가로로 좁은 경우 양쪽에 빈 띠가 표시됩니다. ### 게시 diff --git a/packages/twenty-docs/l/ko/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/ko/developers/extend/apps/tutorials/document-generator/publishing.mdx index 8d11830dda..21d519e12c 100644 --- a/packages/twenty-docs/l/ko/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/ko/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -8,7 +8,7 @@ description: 마켓플레이스 메타데이터를 추가하고 앱을 게시하 ## 마켓플레이스 메타데이터 추가 -[application config](/l/ko/developers/extend/apps/config/application)는 마켓플레이스에 표시되는 식별 정보를 포함합니다. 작성자, 카테고리, 로고, 지원 링크 등이 여기에 포함됩니다. `public/`에 로고를 넣고 `logoUrl`로 참조하세요. +[application config](/l/ko/developers/extend/apps/config/application)는 마켓플레이스에 표시되는 식별 정보를 포함합니다. 작성자, 카테고리, 로고, 지원 링크 등이 여기에 포함됩니다. `public/`에 로고를 넣고 `logo`로 참조하세요. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -18,7 +18,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/ko/developers/extend/apps', @@ -40,12 +40,13 @@ export default defineApplication({ ## 갤러리 스크린샷 추가 -마켓플레이스 등록 정보는 스크린샷만으로도 충분히 어필됩니다. 몇 개의 PNG 파일을 `public/gallery/`에 넣고 `screenshots`로 참조하세요. 그러면 목록 페이지에서 갤러리로 렌더링됩니다. +마켓플레이스 등록 정보는 스크린샷만으로도 충분히 어필됩니다. 몇 개의 PNG 파일을 +`public/gallery/`에 넣고 `galleryImages`로 참조하세요. 그러면 목록 페이지에서 배열 순서대로 갤러리로 렌더링됩니다. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/config/application.mdx index 55ad7f514a..c04dd1dc7c 100644 --- a/packages/twenty-docs/l/pt/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/pt/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ Se você planeja [publicar seu app](/l/pt/developers/extend/apps/operations/publ | ------------------ | ----------------------------------------------------------------------------------------------------------------- | | `author` | Nome do autor ou da empresa | | `category` | Categoria do app para filtragem no marketplace | -| `logoUrl` | Caminho para o logo do seu app (por exemplo, `public/logo.png`) | -| `screenshots` | Array de caminhos de capturas de tela (por exemplo, `public/screenshot-1.png`) | +| `logo` | Caminho para o logotipo do seu aplicativo empacotado em `public/` (p. ex., `public/logo.png`) | +| `galleryImages` | Array de caminhos de imagem da galeria empacotado em `public/` (por exemplo, `public/screenshot-1.png`) | | `aboutDescription` | Descrição em markdown mais longa para a aba "Sobre". Se omitido, o marketplace usa o `README.md` do pacote no npm | | `websiteUrl` | Link para seu site | | `termsUrl` | Link para os Termos de Serviço | | `emailSupport` | Endereço de e-mail de suporte | | `issueReportUrl` | Link para o rastreador de problemas | + + +`logoUrl` e `screenshots` são aliases depreciadas de `logo` e `galleryImages`. URLs absolutas externas (`http://` ou `https://`) não são suportados para estes campos: eles são descartados com um aviso no momento da compilação. Agrupe as imagens na pasta `public/` do seu aplicativo. + diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/config/public-assets.mdx index ab50185c48..5202b667ad 100644 --- a/packages/twenty-docs/l/pt/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/pt/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ Arquivos colocados em `public/` são: * **Publicamente acessíveis** — depois de sincronizados com o servidor, os recursos são servidos em uma URL pública. Não é necessária autenticação para acessá-los. * **Disponíveis em componentes de front-end** — use URLs de recursos para exibir imagens, ícones ou qualquer mídia dentro de seus componentes React. * **Disponíveis em funções lógicas** — referencie URLs de recursos em e-mails, respostas de API ou qualquer lógica no lado do servidor. -* **Usados para metadados do marketplace** — os campos `logoUrl` e `screenshots` em `defineApplication()` referenciam arquivos desta pasta (por exemplo, `public/logo.png`). Eles são exibidos no marketplace quando seu app é publicado. +* **Usado para metadados de marketplace** — os campos `logo` e `galleryImages` no arquivo de referência `defineApplication()` desta pasta (por exemplo, `public/logo.png`). Eles são exibidos no marketplace quando seu app é publicado. URLs absolutas externas são ignoradas para esses campos — agrupe as imagens em `public/`. * **Sincronizados automaticamente no modo de desenvolvimento** — quando você adiciona, atualiza ou exclui um arquivo em `public/`, ele é sincronizado automaticamente com o servidor. Não é necessário reiniciar. * **Incluídos nas compilações** — `yarn twenty dev:build` agrupa todos os recursos públicos na saída de distribuição. diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/project-structure.mdx index c2a0f4b80e..9a00033e46 100644 --- a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## Arquivos principais @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | Um teste de unidade mais um teste de integração (com sua configuração global) que sincroniza o app com um servidor real. | | `public/` | Recursos estáticos (imagens, fontes) servidos com seu aplicativo. | | `AGENTS.md` / `CLAUDE.md` | Orientação para agentes de codificação de IA que trabalham no app. | +| `CHANGELOG.md` / `SETUP.md` | Registro de alterações importantes e instruções de configuração para desenvolvimento local. | **A organização de arquivos fica a seu critério.** As pastas acima são convenções — o SDK detecta entidades por meio de análise de AST em chamadas a `export default defineEntity(...)`, independentemente de onde o arquivo esteja. diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/operations/publishing.mdx index 0c037ff0ae..6241db3026 100644 --- a/packages/twenty-docs/l/pt/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/pt/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ Publicar no npm torna seu aplicativo descobrível no Marketplace da Twenty. Qual ### Metadados do Marketplace -A configuração `defineApplication()` oferece suporte a campos opcionais que controlam como seu app aparece no marketplace. Use `logoUrl` e `screenshots` para referenciar imagens da pasta `public/`: +A configuração `defineApplication()` oferece suporte a campos opcionais que controlam como seu app aparece no marketplace. Use `logo` e `galleryImages` para referenciar imagens da pasta `public/`: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ Veja o [acordeão de defineApplication](/l/pt/developers/extend/apps/config/application#marketplace-metadata) na página Building Apps para a lista completa de campos do marketplace (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, etc.). -#### Dimensões recomendadas para capturas de tela +#### Dimensões recomendadas para imagens da galeria -O marketplace renderiza `screenshots` em um contêiner fixo de `8:5` (por exemplo, `1600×1000 px`). +O marketplace renderiza `galleryImages` em um contêiner fixo de `8:5` (por exemplo, `1600×1000 px`). -Capturas de tela de qualquer proporção são exibidas por completo e nunca são cortadas, mas qualquer coisa significativamente mais alta ou mais estreita que `8:5` exibirá faixas vazias nas laterais. +Imagens da galeria de qualquer proporção são exibidas por completo e nunca são cortadas, mas qualquer coisa significativamente mais alta ou mais estreita que `8:5` exibirá faixas vazias nas laterais. ### Publicar diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/tutorials/document-generator/publishing.mdx index dbf435150c..50ce7d4946 100644 --- a/packages/twenty-docs/l/pt/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/pt/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ Seu aplicativo funciona. O último passo é descrevê-lo para o mercado e public A [aplicação config](/l/pt/developers/extend/apps/config/application) transporta a identidade que aparece no mercado: autor, categoria, logotipo e suporte links -. Coloque um logotipo em `public/` e referencie-o com `logoUrl`. +. Coloque um logotipo em `public/` e faça referência a ele com `logo`. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/pt/developers/extend/apps', @@ -43,14 +43,14 @@ Também adicione a palavra-chave `vinte app` ao `package.json` para que o aplica ## Adicionar capturas de tela da galeria -Uma lista de mercado vende a si mesma com screenshots. Colocar alguns PNGs em -`public/gallery/` e referenciá-los com `screenshots` — eles renderizam como galeria -na página de listagem. +Uma lista de mercado vende a si mesma com screenshots. Coloque alguns PNGs em +`public/gallery/` e faça referência a eles com `galleryImages` — eles são renderizados como uma +galeria na página de listagem, na ordem do array. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/config/application.mdx index 78cc718235..122eb39750 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ Dacă intenționați să [publicați aplicația](/l/ro/developers/extend/apps/op | ------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | `author` | Numele autorului sau al companiei | | `category` | Categoria aplicației pentru filtrarea în marketplace | -| `logoUrl` | Calea către logo-ul aplicației (de ex., `public/logo.png`) | -| `screenshots` | Array de căi către capturi de ecran (de ex., `public/screenshot-1.png`) | +| `logo` | Calea către logo-ul aplicației tale inclus în `public/` (de ex., `public/logo.png`) | +| `galleryImages` | Array de căi către imaginile din galerie incluse în `public/` (de ex., `public/screenshot-1.png`) | | `aboutDescription` | Descriere markdown mai lungă pentru fila "About". Dacă este omis, marketplace-ul folosește `README.md` al pachetului de pe npm | | `websiteUrl` | Link către site-ul dvs. | | `termsUrl` | Link către termenii de serviciu | | `emailSupport` | Adresă de e-mail pentru suport | | `issueReportUrl` | Link către sistemul de urmărire a problemelor | + + +`logoUrl` și `screenshots` sunt aliasuri învechite pentru `logo` și `galleryImages`. URL-urile absolute externe (`http://` sau `https://`) nu sunt acceptate pentru aceste câmpuri: ele sunt eliminate cu un avertisment în timpul build-ului. În schimb, include imaginile în folderul `public/` al aplicației tale. + diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/config/public-assets.mdx index 14e067eea3..6f8dbbf1e0 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ Fișierele plasate în `public/` sunt: * **Accesibile public** — odată sincronizate pe server, resursele sunt servite la un URL public. Nu este necesară autentificarea pentru a le accesa. * **Disponibile în componentele frontend** — folosiți URL-urile resurselor pentru a afișa imagini, pictograme sau orice media în componentele React. * **Disponibile în funcțiile logice** — referiți URL-urile resurselor în e-mailuri, răspunsuri API sau orice logică pe server. -* **Utilizate pentru metadatele marketplace-ului** — câmpurile `logoUrl` și `screenshots` din `defineApplication()` fac referire la fișiere din acest folder (de ex., `public/logo.png`). Acestea sunt afișate în marketplace când aplicația este publicată. +* **Utilizate pentru metadatele marketplace-ului** — câmpurile `logo` și `galleryImages` din `defineApplication()` fac referire la fișiere din acest folder (de ex., `public/logo.png`). Acestea sunt afișate în marketplace când aplicația este publicată. URL-urile absolute externe sunt ignorate pentru aceste câmpuri — încorporează imaginile în `public/` în schimb. * **Sincronizate automat în modul de dezvoltare** — când adăugați, actualizați sau ștergeți un fișier în `public/`, acesta este sincronizat automat cu serverul. Nu este nevoie de repornire. * **Incluse în build-uri** — `yarn twenty dev:build` împachetează toate resursele publice în outputul de distribuție. diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/getting-started/project-structure.mdx index 4ec1e020c9..b5327bf6f5 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## Fișiere cheie @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | Un test unitar plus un test de integrare (cu configurarea sa globală) care sincronizează aplicația cu un server real. | | `public/` | Resurse statice (imagini, fonturi) servite împreună cu aplicația. | | `AGENTS.md` / `CLAUDE.md` | Ghid pentru agenții AI de programare care lucrează la aplicație. | +| `CHANGELOG.md` / `SETUP.md` | Jurnal de modificări notabile și instrucțiuni de configurare pentru dezvoltare locală. | **Organizarea fișierelor ține de dvs.** Folderele de mai sus sunt convenții — SDK-ul detectează entitățile prin analiză AST pe apelurile `export default defineEntity(...)`, indiferent unde se află fișierul. diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/operations/publishing.mdx index a1cd8a4125..787eef342f 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ Publicarea pe npm face ca aplicația ta să poată fi descoperită în marketpla ### Metadate pentru marketplace -Configurația `defineApplication()` acceptă câmpuri opționale care controlează modul în care aplicația ta apare în marketplace. Folosește `logoUrl` și `screenshots` pentru a face referire la imaginile din folderul `public/`: +Configurația `defineApplication()` acceptă câmpuri opționale care controlează modul în care aplicația ta apare în marketplace. Folosește `logo` și `galleryImages` pentru a face referire la imaginile din folderul `public/`: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ Vezi [acordeonul defineApplication](/l/ro/developers/extend/apps/config/application#marketplace-metadata) din pagina Building Apps pentru lista completă de câmpuri ale marketplace-ului (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, etc.). -#### Dimensiuni recomandate pentru capturi de ecran +#### Dimensiuni recomandate pentru imaginile din galerie -Marketplace-ul redă `screenshots` într-un container fix cu raport `8:5` (de exemplu, `1600×1000 px`). +Marketplace-ul redă `galleryImages` într-un container fix cu raport `8:5` (de exemplu, `1600×1000 px`). -Capturile de ecran cu orice raport de aspect sunt afișate integral și nu sunt niciodată decupate, însă orice este semnificativ mai înalt sau mai îngust decât `8:5` va afișa benzi goale pe laterale. +Imaginile din galerie cu orice raport de aspect sunt afișate integral și nu sunt niciodată decupate, însă orice imagine semnificativ mai înaltă sau mai îngustă decât `8:5` va afișa benzi goale pe laterale. ### Publicare diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/tutorials/document-generator/publishing.mdx index 47215de7c2..c959051131 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ Aplicația dvs. funcționează. Ultimul pas este să îl descriem pentru piață [application config](/l/ro/developers/extend/apps/config/application) posedă identitatea care apare în bazar: author, categorie, logo, and support -link-uri. Puneți un logo în `public/` și trimiteți-l cu `logoUrl`. +link-uri. Pune un logo în `public/` și fă referire la el cu `logo`. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/ro/developers/extend/apps', @@ -43,14 +43,14 @@ Adăugați de asemenea cuvântul cheie `douăzeci și douăzeci de aplicații` ## Adaugă capturi de ecran galerie -O listă de marketplace se vinde cu capturi de ecran. Plasați câteva PNG-uri în -`public/gallery/` și trimiteți-le cu `capturi de ecran` - ele se redau ca galerie -pe pagina de listare. +O listă de marketplace se vinde cu capturi de ecran. Plasează câteva fișiere PNG în +`public/gallery/` și fă referire la ele cu `galleryImages` — acestea sunt afișate ca o +galerie pe pagina listării, în ordinea din array. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/config/application.mdx index d264315ad1..2e8cdd909f 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ Eğer [uygulamanızı yayımlamayı](/l/tr/developers/extend/apps/operations/pub | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | | `author` | Yazar veya şirket adı | | `category` | Pazaryerinde filtreleme için uygulama kategorisi | -| `logoUrl` | Uygulamanızın logosuna giden yol (örn. `public/logo.png`) | -| `screenshots` | Ekran görüntüsü yollarının dizisi (örn. `public/screenshot-1.png`) | +| `logo` | Uygulamanızın `public/` klasöründe paketlenmiş logo dosyasının yolu (örn. `public/logo.png`) | +| `galleryImages` | `public/` içinde paketlenmiş galeri görseli yollarının dizisi (örn. `public/screenshot-1.png`) | | `aboutDescription` | "Hakkında" sekmesi için daha uzun bir markdown açıklaması. Belirtilmezse, pazaryeri npm'deki paketin `README.md` dosyasını kullanır | | `websiteUrl` | Web sitenize bağlantı | | `termsUrl` | Hizmet Koşulları'na bağlantı | | `emailSupport` | Destek e-posta adresi | | `issueReportUrl` | Sorun izleyicisine bağlantı | + + +`logoUrl` ve `screenshots`, `logo` ve `galleryImages` için kullanımdan kaldırılmış takma adlardır. Bu alanlar için harici mutlak URL'ler (`http://` veya `https://`) desteklenmez: derleme sırasında uyarı ile birlikte kaldırılırlar. Bunun yerine görselleri uygulamanızın `public/` klasöründe paketleyin. + diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/config/public-assets.mdx index 3837270c96..059b404db1 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ Uygulamanızın kökündeki `public/` klasörü, statik dosyaları barındırır * **Herkese açık olarak erişilebilir** — sunucuya senkronize edildikten sonra varlıklar genel bir URL'den sunulur. Onlara erişmek için kimlik doğrulama gerekmez. * **Ön uç bileşenlerinde kullanılabilir** — React bileşenlerinizin içinde görseller, simgeler veya herhangi bir medyayı göstermek için varlık URL'lerini kullanın. * **Mantık işlevlerinde kullanılabilir** — e-postalarda, API yanıtlarında veya herhangi bir sunucu tarafı mantıkta varlık URL'lerine referans verin. -* **Pazar yeri üst verileri için kullanılır** — `defineApplication()` içindeki `logoUrl` ve `screenshots` alanları bu klasördeki dosyalara referans verir (örn. `public/logo.png`). Bunlar, uygulamanız yayımlandığında pazar yerinde görüntülenir. +* **Pazar yeri üst verileri için kullanılır** — `defineApplication()` içindeki `logo` ve `galleryImages` alanları bu klasördeki dosyalara referans verir (örn. `public/logo.png`). Bunlar, uygulamanız yayımlandığında pazar yerinde görüntülenir. Bu alanlar için harici mutlak URL'ler yok sayılır — bunun yerine görselleri `public/` içine paketleyin. * **Geliştirme modunda otomatik senkronize edilir** — `public/` içinde bir dosya eklediğinizde, güncellediğinizde veya sildiğinizde otomatik olarak sunucuya senkronize edilir. Yeniden başlatma gerekmez. * **Derlemelere dahil edilir** — `yarn twenty dev:build`, tüm genel varlıkları dağıtım çıktısına paketler. diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started/project-structure.mdx index 86c0a702ef..56e93e1218 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## Temel dosyalar @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | Uygulamayı gerçek bir sunucuya karşı senkronize eden (genel kurulumu ile birlikte) bir birim testi artı bir entegrasyon testi. | | `public/` | Uygulamanızla birlikte sunulan statik varlıklar (görüntüler, yazı tipleri). | | `AGENTS.md` / `CLAUDE.md` | Uygulama üzerinde çalışan yapay zekâ kodlama ajanları için yönergeler. | +| `CHANGELOG.md` / `SETUP.md` | Önemli değişikliklerin değişiklik günlüğü ve yerel geliştirme için kurulum talimatları. | **Dosya organizasyonu size kalmış.** Yukarıdaki klasörler birer konvansiyondur — SDK, dosyanın nerede olduğundan bağımsız olarak `export default defineEntity(...)` çağrılarını AST analizi yoluyla algılar. diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/operations/publishing.mdx index fd09dec684..8f6d1a62c9 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ npm’ye yayımlamak, uygulamanızın Twenty pazaryerinde keşfedilebilir olmas ### Pazaryeri meta verileri -`defineApplication()` yapılandırması, uygulamanızın pazar yerinde nasıl görüneceğini kontrol eden isteğe bağlı alanları destekler. `public/` klasöründeki görsellere başvurmak için `logoUrl` ve `screenshots` kullanın: +`defineApplication()` yapılandırması, uygulamanızın pazar yerinde nasıl görüneceğini kontrol eden isteğe bağlı alanları destekler. `public/` klasöründeki görsellere başvurmak için `logo` ve `galleryImages` kullanın: ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ Pazar yeri alanlarının tam listesi için Uygulama Oluşturma sayfasındaki [defineApplication akordeonu](/l/tr/developers/extend/apps/config/application#marketplace-metadata)'na bakın (`author`, `category`, `aboutDescription`, `websiteUrl`, `termsUrl`, vb.). -#### Önerilen ekran görüntüsü boyutları +#### Önerilen galeri görseli boyutları -Marketplace, `screenshots`'ı sabit `8:5` oranlı bir kapsayıcıda görüntüler (örneğin, `1600×1000 px`). +Marketplace, `galleryImages`'ı sabit `8:5` oranlı bir kapsayıcıda görüntüler (örneğin, `1600×1000 px`). -Herhangi bir en-boy oranındaki ekran görüntüleri eksiksiz görüntülenir ve asla kırpılmaz, ancak `8:5`'ten belirgin ölçüde daha uzun veya daha dar olanlarda yanlarda boş bantlar görünür. +Herhangi bir en-boy oranındaki galeri görselleri eksiksiz görüntülenir ve asla kırpılmaz, ancak `8:5`'ten belirgin ölçüde daha uzun veya daha dar olanlarda yanlarda boş bantlar görünür. ### Yayımla diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/tutorials/document-generator/publishing.mdx index cb93433980..0681755913 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -8,7 +8,7 @@ Uygulamanız çalışıyor. Son adım, onu pazaryeri için tanımlamak ve yayım ## Pazaryeri meta verilerini ekleyin -[Application config](/l/tr/developers/extend/apps/config/application), pazaryerinde görünen kimliği taşır: yazar, kategori, logo ve destek bağlantıları. `public/` içine bir logo yerleştirin ve `logoUrl` ile referans verin. +[Application config](/l/tr/developers/extend/apps/config/application), pazaryerinde görünen kimliği taşır: yazar, kategori, logo ve destek bağlantıları. `public/` içine bir logo yerleştirin ve `logo` ile referans verin. ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -18,7 +18,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/tr/developers/extend/apps', @@ -40,12 +40,13 @@ Ayrıca uygulamanın bulunabilir olması için `package.json` dosyasına `twenty ## Galeri ekran görüntüleri ekleyin -Bir pazaryeri listesi, kendini ekran görüntüleriyle satar. Birkaç PNG dosyasını `public/gallery/` içine bırakın ve bunlara `screenshots` ile referans verin — listeleme sayfasında bir galeri olarak görüntülenirler. +Bir pazaryeri listesi, kendini ekran görüntüleriyle satar. Birkaç PNG dosyasını +`public/gallery/` içine bırakın ve bunlara `galleryImages` ile referans verin — listeleme sayfasında, dizi sırasına göre bir galeri olarak görüntülenirler. ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png', diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx index 677a437c49..c4f8f570d7 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/config/application.mdx @@ -109,10 +109,14 @@ const config = JSON.parse(process.env.PROVIDER_CONFIG ?? '{}'); // '{"retries":3 | ------------------ | -------------------------------------------------------------- | | `作者` | 作者或公司名称 | | `类别` | 用于应用市场筛选的应用类别 | -| `logoUrl` | 应用徽标的路径（例如 `public/logo.png`） | -| `screenshots` | 截图路径数组（例如 `public/screenshot-1.png`） | +| `logo` | 捆绑在`public/`中的应用徽标的路径(例如`public/logo.png`) | +| `galleryImages` | 在`public/`中捆绑的相册图像路径数组(例如`public/screenshot-1.png`) | | `aboutDescription` | 用于“关于”选项卡的更长的 Markdown 描述。 如果省略，市场将使用该软件包在 npm 上的 `README.md`。 | | `websiteUrl` | 你的网站链接 | | `termsUrl` | 服务条款链接 | | `emailSupport` | 支持电子邮件地址 | | `issueReportUrl` | 问题跟踪器链接 | + + +`logoUrl`和`screshots`被废弃的 `logo` 和 `GalleryImages` 的别名。 这些字段不支持外部绝对链接 (`http://` 或 `https://`) 。它们会在构建时被丢弃，并附有警告。 将图像捆绑在你的应用的 "public/" 文件夹中。 + diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/config/public-assets.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/config/public-assets.mdx index 810db0388a..75ac289533 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/config/public-assets.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/config/public-assets.mdx @@ -11,7 +11,7 @@ icon: folder-open * **公开可访问**——同步到服务器后，资源将通过公共 URL 提供服务。 访问它们无需身份验证。 * **在前端组件中可用**——使用资源 URL 在 React 组件中显示图像、图标或任何媒体。 * **在逻辑函数中可用**——在电子邮件、API 响应或任何服务端逻辑中引用资源 URL。 -* **用于市场元数据**——`defineApplication()` 中的 `logoUrl` 和 `screenshots` 字段引用此文件夹中的文件（例如，`public/logo.png`）。 应用发布后，这些内容会显示在市场中。 +* **用于市场元数据**——`defineApplication()` 中的 `logo` 和 `galleryImages` 字段引用此文件夹中的文件（例如，`public/logo.png`）。 应用发布后，这些内容会显示在市场中。 对于这些字段，外部绝对 URL 会被忽略——请改为将图像打包到 `public/` 中。 * **在开发模式下自动同步**——当在 `public/` 中添加、更新或删除文件时，会自动同步到服务器。 无需重启。 * **包含在构建中**——`yarn twenty dev:build` 会将所有公共资源打包到分发产物中。 diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/project-structure.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/project-structure.mdx index 935a2a3570..9f1eb55b9e 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/project-structure.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/project-structure.mdx @@ -33,7 +33,7 @@ my-twenty-app/ vitest.unit.config.ts # Unit test runner config tsconfig.json, tsconfig.spec.json .nvmrc, .yarnrc.yml, .oxlintrc.json - README.md, AGENTS.md, CLAUDE.md + README.md, AGENTS.md, CLAUDE.md, CHANGELOG.md, SETUP.md ``` ## 关键文件 @@ -47,6 +47,7 @@ my-twenty-app/ | `src/__tests__/` | 一个单元测试加一个集成测试（带有其全局设置），用于将应用与真实服务器进行同步。 | | `public/` | 随应用一起提供的静态资源（图像、字体）。 | | `AGENTS.md` / `CLAUDE.md` | 为在该应用上工作的 AI 编码代理提供指导。 | +| `CHANGELOG.md` / `SETUP.md` | 显著更改的更新日志以及用于本地开发的设置说明。 | **文件组织由你决定。** 上述文件夹只是约定——SDK 通过对 `export default defineEntity(...)` 调用进行 AST 分析来检测实体，而不受文件所在位置影响。 diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx index e8c6577af4..da99a8a73b 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/operations/publishing.mdx @@ -180,15 +180,15 @@ yarn twenty app:publish --private ### 应用市场元数据 -`defineApplication()` 配置支持可选字段，用于控制你的应用在市场中的展示方式。 使用 `logoUrl` 和 `screenshots` 来引用 `public/` 文件夹中的图片： +`defineApplication()` 配置支持可选字段，用于控制你的应用在市场中的展示方式。 使用 `logo` 和 `galleryImages` 来引用 `public/` 文件夹中的图片： ```ts src/application-config.ts export default defineApplication({ universalIdentifier: '...', displayName: 'My App', description: 'A great app', - logoUrl: 'public/logo.png', - screenshots: [ + logo: 'public/logo.png', + galleryImages: [ 'public/screenshot-1.png', 'public/screenshot-2.png', ], @@ -197,12 +197,12 @@ export default defineApplication({ 完整的市场字段列表（`author`、`category`、`aboutDescription`、`websiteUrl`、`termsUrl` 等）请参见“构建应用”页面中的 [defineApplication 折叠面板](/l/zh/developers/extend/apps/config/application#marketplace-metadata)。 -#### 建议的屏幕截图尺寸 +#### 建议的图库图片尺寸 -该市场会在固定的 `8:5` 容器中渲染 `screenshots`（例如，`1600×1000 px`）。 +该市场会在固定的 `8:5` 容器中渲染 `galleryImages`（例如，`1600×1000 px`）。 -任意纵横比的屏幕截图都会完整显示，且绝不会被裁剪，但相对于 `8:5` 明显更高或更窄的图片，两侧会出现空白边。 +任意纵横比的图库图片都会完整显示，且绝不会被裁剪，但相对于 `8:5` 明显更高或更窄的图片，两侧会出现空白边。 ### 发布 diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/tutorials/document-generator/publishing.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/tutorials/document-generator/publishing.mdx index 06d289b927..cbde72c5c3 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/tutorials/document-generator/publishing.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/tutorials/document-generator/publishing.mdx @@ -10,7 +10,7 @@ description: 添加市场元数据并发布您的应用。 [应用程序配置](/l/zh/developers/extend/apps/config/application) 带有显示在市场中的 身份：作者、类别、标志和支持 -链接。 在 `public/` 中放置一个徽标，然后使用 `logoUrl` 引用。 +链接。 将一个 logo 放入 `public/` 中，并使用 `logo` 来引用它。 ```ts filename="src/application-config.ts" import { defineApplication } from 'twenty-sdk/define'; @@ -20,7 +20,7 @@ export default defineApplication({ displayName: 'Document Generator', description: 'Create reusable document templates and generate personalized documents from your CRM records.', - logoUrl: 'public/document-generator.svg', + logo: 'public/document-generator.svg', author: 'Twenty', category: 'Productivity', websiteUrl: 'https://docs.twenty.com/l/zh/developers/extend/apps', @@ -42,14 +42,14 @@ export default defineApplication({ ## 添加相册截图 -市场列表用屏幕截图销售自己。 在 -`public/gallery/` 中拖放几个PNGs，然后使用 `screshots` - 它们在列表页面上渲染成一个相册 -。 +市场列表用屏幕截图销售自己。 将几个 PNG 放入 +`public/gallery/` 中，并使用 `galleryImages` 来引用它们——它们会按照数组顺序在列表页面上 +以画廊形式渲染。 ```ts filename="src/application-config.ts" export default defineApplication({ // ...identity from above - screenshots: [ + galleryImages: [ 'public/gallery/01-generated-document.png', 'public/gallery/02-command-menu.png', 'public/gallery/03-template-editor.png',