عن المشروع

# astro-umami > [تكامل Astro](https://docs.astro.build/en/guides/integrations-guide/) لإضافة [Umami Analytics](https://umami.is/) إلى موقعك. [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/yeskunall/astro-umami) [![Greptile: The War on Bugs](https://www.greptile.com/badge.svg)](https://www.greptile.com/?ref=yeskunall/astro-umami) [![E2E tests](https://github.com/yeskunall/astro-umami/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/yeskunall/astro-umami/actions/workflows/test.yml) [![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/yeskunall/astro-umami/blob/main/license) [![npm version](https://badge.fury.io/js/@yeskunall%2Fastro-umami.svg)](https://badge.fury.io/js/@yeskunall%2Fastro-umami) ![monthly downloads](https://img.shields.io/npm/dm/@yeskunall%2Fastro-umami.svg?logo=npm) ## الميزات الرئيسية - يكشف تلقائيًا عما إذا كنت تستخدم [View Transitions](https://docs.astro.build/en/guides/view-transitions/) ويضيف سمة [`data-astro-rerun`](https://docs.astro.build/en/guides/view-transitions/#data-astro-rerun) - يعطل الأحداث وعروض الصفحات أثناء التطوير - يدعم جميع خيارات [التكوين](https://docs.umami.is/docs/tracker-configuration)، على عكس [`astro-analytics`](https://github.com/Destiner/astro-analytics) - يوفر توثيقًا مدمجًا لجميع خيارات التكوين (بفضل [TypeScript](https://github.com/yeskunall/astro-umami/blob/main/packages/astro-umami/src/index.ts#L7)) - (_اختياري_) خدمة سكريبت التتبع باستخدام [Partytown](https://partytown.qwik.dev/) (الإصدار 0.0.5 وما بعده) - **محافظ عليه بنشاط** - **صفر تبعيات** ## الاستخدام ### التثبيت شغّل الأمر التالي من دليل مشروعك اتبع التعليمات: ```sh pnpm astro add @yeskunall/astro-umami@0.0.9 ``` سيؤدي ذلك إلى تثبيت الإضافة وإجراء التغييرات المناسبة على إعدادات Astro تلقائيًا. ### التثبيت اليدوي 1. ثبّت التبعيات المطلوبة ```sh pnpm add @yeskunall/astro-umami@0.0.9 ``` 2. أضف التكامل إلى إعدادات Astro: ```diff + import umami from "@yeskunall/astro-umami"; export default defineConfig({ integrations: [ + umami({ id: "94db1cb1-74f4-4a40-ad6c-962362670409" }), ], }); ``` ###### لجميع الخيارات القابلة للتكوين، انظر [الواجهة البرمجية](https://github.com/yeskunall/astro-umami/blob/main/packages/astro-umami/src/index.ts#L7).