התקנת מונה Stats4U באתר סטטי בלי לחשוף גישה פרטית

אתר סטטי יכול לטעון מונה Stats4U בלי להריץ PHP או לתחזק מסד נתונים של מבקרים באחסון שלו. הדפדפן טוען את ההטמעה משירות Stats4U והספירה מתבצעת שם. הצלחת ההגדרה עדיין תלויה בקוד ה־HTML שפורסם, במדיניות האחסון ובכך שדפדפן המבקר מאפשר את הבקשות הנדרשות.

הכנת ההטמעה הציבורית

1. למונה חדש, יש לבחור עיצוב ולהעתיק את הקוד שנוצר. למונה קיים, יש לשמור על מספר המונה שלו. יש לשמור את קישור הניהול הפרטי במקום מאובטח לפני עריכת האתר. מונה יכול לעבוד ללא חשבון, ועדיין צריך להגן על גישת הבעלים אליו.
2. יש להכניס רק את קוד ההטמעה הציבורי לתבנית ה־HTML המשותפת, במקום שבו המונה אמור להופיע. מחולל אתרים סטטיים חייב לכלול את התבנית הזאת בדפים שפורסמו. יש לבדוק את קוד ה־HTML שנוצר אחרי הפריסה; עריכת רכיב מקור אינה מוכיחה שהוא נמצא בדף החי.
3. יש להשאיר את אסימון הבעלים, קישור הניהול ומפתחות ה־API מחוץ לקוד HTML ציבורי ולמאגרי קוד. מספר המונה ואפשרויות העיצוב הציבוריות מספיקים להטמעה הרגילה. יש לבדוק את הטקסט המועתק כולו לפני הכנסתו לקומיט; אין לפרסם סימניות פרטיות כהוראות התקנה.

יש להשתמש בהטמעה שנתמכת באחסון

כאשר מותרים סקריפטים חיצוניים, יש להשתמש בקטע קוד ה־JavaScript שנוצר ובכתובת שבה מתארח הקובץ s4u.js. כך עדכונים יכולים להגיע להטמעה. עותק שהורד נשאר בגרסה שהועתקה אלא אם מעדכנים אותו בנפרד; שינוי האתר אינו מעדכן אוטומטית את הקובץ הזה.

כאשר מתקבלים רק תמונות, Markdown או BBCode, יש להשתמש בהטמעה המתאימה שנוצרה. היא יכולה לספור בקשות לתמונה, ואילו פרטי הדף תלויים ב־HTTP Referer או בכתובת שנמסרה במפורש. אירועים אוטומטיים אופציונליים דורשים JavaScript; תמונה לבדה אינה יכולה לצפות בתוצאה מאומתת של טופס.

בדיקת התוצאה שפורסמה בבטחה

יש לבדוק בלוח הרשת של הדפדפן דף בדיקה שבבעלות הבודק ושיש הרשאה לבדוק אותו. יש לבדוק את מספר המונה, קטעי קוד כפולים ומשאבים חסומים. מדיניות Content Security Policy, סינון בעורך או תוסף דפדפן עשויים למנוע את טעינת הסקריפט או התמונה. אין להשבית אמצעי אבטחה רחבים רק כדי שיופיע תג.

ביקור רגיל בדף עשוי להיספר. אין לפתוח ידנית את כתובת תמונת הספירה או לרענן אותה שוב ושוב לצורך אבחון ההתקנה. עיצוב בלתי נראה יכול להיטען כראוי בלי להציג תג; יש לבדוק בקשות ואת הדוח המתאים במקום להוסיף קטע קוד נוסף רק כדי להציג משהו.

יש לדעת במה המונה אינו יכול לצפות

המונה מדווח על בקשות ועל מדידות נתמכות שמגיעות לשירות Stats4U. הוא אינו רואה כל בקשה שמטפל בה האחסון הסטטי, שגיאות שרת, הורדות שנכשלו או רוחב פס. לשם כך נדרשים יומני האחסון או הניטור שלו, אם הם זמינים. אחסון סטטי אינו מבטיח שמידע כזה אינו זמין.

אתר סטטי עדיין זקוק לתוכן מתוחזק, לחשבון פרסום מוגן ולהודעת פרטיות מתאימה. מונה אינו מסיר את האחריות הזאת. יש להפעיל מדידות קמפיינים או אירועים אופציונליות רק כאשר אופן הגדרתן מובן; התקנת קטע הקוד הבסיסי אינה ממלאת כל דוח מתקדם.

יש לבחור ולפרסם את ההטמעה הנכונה

מדריך ההטמעה מסביר את פורמטי הקוד הזמינים ואת הבדיקות לאחר ההטמעה.

לפתיחת מדריך ההטמעה