عن المشروع

publii-goatcounter-analytics-plugin هي إضافة لـ [Publii](https://getpublii.com/)، وهو مولّد مواقع ثابتة ومنصة إدارة محتوى مفتوحة المصدر. تتيح لأصحاب المواقع تضمين تحليلات [GoatCounter](https://www.goatcounter.com) وعدادات زوار اختيارية في مواقعهم المنشورة دون المساس بخصوصية المستخدمين. ## الميزات - تكامل بسيط لرمز تتبع GoatCounter في المواقع المُنشأة بواسطة Publii. - عرض اختياري لعداد الزوار بخيارات تنسيق متعددة: HTML وSVG وPNG. - تخصيص مكان العداد باستخدام محددات CSS (الافتراضي هو `footer`). - خيار إزالة نص العلامة التجارية "by GoatCounter" من العداد. - دعم وضع المعاينة لاختبار التحليلات قبل النشر المباشر. ## الإعداد لتكوين الإضافة: 1. **أدخل نقطة نهاية GoatCounter**: انسخ عنوان URL الخاص بنقطة نهاية GoatCounter إلى حقل تكوين الإضافة ضمن Publii. 2. **انتقل إلى إعدادات الإضافة**: في Publii، انتقل إلى إعدادات موقعك واختر إضافة GoatCounter Integration تحت قسم الإضافات. 3. **أدخل كود GoatCounter**: الصق كود تحليلات GoatCounter الخاص بك في الحقل المخصص لربط موقعك. 4. **وضع المعاينة**: فعّلخراج التحليلات في وضع المعاينة للاختبار. عطّله قبل النشر مباشرة لمنع تشويه البيانات. ## عداد الزوار لعرض عداد زوار على موقعك: 1. **تفعيل العداد**: فعّل خيار "Show Visitor Counter" في إعدادات الإضافة. يجب أيضاً تفعيل خيار "Allow adding visitor counts on your website" في لوحة إعدادات موقعك على GoatCounter، وهو غير مفعل افتراضياً. 2. **تحديد محدد CSS**: حدد محدد العنصر الأب الذي سيتم إلحاق العداد به (الافتراضي هو `footer`). 3. **اختر نوع العداد**: اختر تنسيق HTML أو SVG أو PNG. 4. **إزالة العلامة التجارية**: أخفِ نص الإسناد "by GoatCounter" اختياريًا. ## التخصيص يتوفر تخصيص CSS اعتماداً على نوع العداد المختار: - **عداد HTML**: صنم `div` المحيط والعناصر الداخلية. - **عداد SVG**: خصص عناصر `#gcvc-border` و`#gcvc-for` و`#gcvc-views` و`#gcvc-by` عبر CSS. راجع [وثائق GoatCounter](https://www.goatcounter.com/help/visitor-counter) للحصول على إرشادات تفصيلية حول التنسيق. ## امتثال GDPR لا تتعامل هذه الإضافة مع موافقة GDPR، نظراً لأن GoatCounter يُعتبر متوافقاً بشكل عام دون الحاجة إلى إشعارات موافقة صريحة.详见[إشعارات موافقة GDPR](https://www.goatcounter.com/help/gdpr) لمزيد من التفاصيل. ## الرخصة رخصة MIT. مُرحّب بالإسهامات عبر طلبات السحب أو قضايا GitHub.