Maria Ratings: Komplett installation och användarguide

Maria Ratings: Inbäddningsbart PHP-recensionssystem

Bli expert på Maria Ratings med denna omfattande installations- och användarguide, som täcker allt från grundläggande inställningar till spamskydd.

1. Systemkrav

PHP: Version 8.0 eller högre.
Tillägg: json och mbstring krävs. Om du väljer MySQL/MariaDB för lagring krävs även tillägget mysqli.
CAPTCHA (Pro): För att använda Cloudflare Turnstile eller Google reCAPTCHA v3 krävs utgående HTTPS (tillägget curl rekommenderas; annars måste allow_url_fopen vara On i serverns php.ini).
E-post (Pro): Utgående SMTP eller PHP mail() krävs för e-postverifiering (Double Opt-in) och admin-notiser.

2. Installationsguide

Steg 1: Ladda upp filerna

Extrahera den nedladdade Maria Ratings-arkivfilen och ladda upp hela mappen till ditt webbhotell via FTP, SFTP eller kontrollpanelens filhanterare.

Steg 2: Kör installationsprogrammet

Gå till installationsfilen i din webbläsare (till exempel: https://dinwebbplats.se/maria-ratings/install.php). Det visuella installationsprogrammet guidar dig genom skapandet av ditt administratörskonto (användarnamn och lösenord).

Steg 3: Välj lagringsdrivrutin

Under installationen måste du välja hur du vill lagra din recensionsdata:

JSON-fillagring: Det enklaste alternativet. Kräver noll konfiguration och är utmärkt för små webbplatser eller testning. Se till att din storage/-mapp har skrivrättigheter.
MySQL/MariaDB: Rekommenderas starkt för produktionsmiljöer, Pro media-arbetsflöden och webbplatser med hög trafik. Du måste ange databasvärd, namn, användarnamn, lösenord och ett tabellprefix.

När installationen är klar kan du logga in på din adminpanel genom att navigera till /admin/.

3. Uppgradera från Free till Pro

Om du uppgraderar från Maria Ratings Free till Pro behöver du inte förlora dina befintliga recensioner:

Ladda upp Pro-filerna och skriv över din befintliga Free-installation.
Viktigt för JSON-användare: Se till att du inte skriver över din befintliga storage/-katalog, eftersom den innehåller din livedata.
Om du använde MySQL/MariaDB kör du helt enkelt Pro-installationsprogrammet och ansluter med exakt samma databasuppgifter. Din befintliga data kommer att kännas igen automatiskt.

4. Bädda in recensionswidgeten

För att visa recensionswidgeten på din webbplats placerar du följande HTML-kodavsnitt exakt där du vill att recensionerna ska visas:

<div data-maria-ratings data-product-key="ditt-produkt-id"></div>
<script src="https://dinwebbplats.se/maria-ratings/embed.js" defer></script>

Obs: Ändra ditt-produkt-id till en unik identifierare för den specifika produkten, tjänsten eller sidan som recenseras. Detta säkerställer att recensioner hålls åtskilda för olika objekt på din webbplats.

5. Adminpanel & Modereringsverktyg

Logga in på din adminpanel (/admin/index.php) för att hantera dina recensioner. Härifrån kan du:

Moderera recensioner: Godkänn, avvisa eller ta bort väntande recensioner.
Svara kunder (Pro): Skriv offentliga ägarsvar direkt under kundernas recensioner.
Exportera data: Ladda ner en CSV-fil med alla dina recensioner för säkerhetskopiering eller extern analys.
Konfigurera inställningar: Justera hastighetsbegränsningar, blockerade ord, obligatoriska formulärfält och tillåtna ursprung.

6. Detaljerad inställningsguide

Maria Ratings adminpanel är uppdelad i flera konfigurationsflikar. Här är en omfattande uppdelning av vad du kan styra i varje avsnitt:

Allmänna inställningar

Automatisk godkännande av recensioner: Välj om recensioner ska publiceras omedelbart eller hållas i panelen för manuell moderering. Du kan också konfigurera den för att automatiskt bara godkänna 4- och 5-stjärniga recensioner.
Recensioner per sida: Kontrollera hur många recensioner som laddas initialt innan användaren måste klicka på "Ladda fler"-knappen.
Sorteringsordning: Ställ in standardbeteendet för sortering (Senaste, Äldsta, Högsta betyg eller Lägsta betyg).
Tema: Byt mellan standardwidget-teman (som Classic eller Dark mode) för att bäst matcha din webbplats estetik.
Tillåtna ursprung: En kritisk säkerhetsinställning. Ange de exakta domänerna (t.ex. https://dinwebbplats.se) där din widget är inbäddad för att förhindra angripare från att skicka recensioner från obehöriga webbplatser.

Formulärfält & Meddelanden

Fältens synlighet & krav: Ta full kontroll över fälten Namn, E-post och Webbplats. För varje fält kan du bestämma om det visas i formuläret, om det är obligatoriskt att fylla i, och om datan visas offentligt på den publicerade recensionen.
Anpassad text & översättningar: Anpassa texten för knappar, formuläretiketter och framgångsmeddelanden. Detta är det perfekta stället att översätta widgeten till ditt lokala språk.

Spamskydd & Säkerhet (Free & Pro)

IP-hastighetsbegränsning: Begränsa hur många recensioner som kan skickas från exakt samma IP-adress inom en specifik tidsram (t.ex. max 3 recensioner per 24 timmar) för att stoppa översvämning.
En recension per e-post: Förhindra användare från att på konstgjord väg blåsa upp betyg genom att skicka flera recensioner för samma produkt med samma e-postadress.
Blockerade ord: Skapa en kommaseparerad lista över förbjudna ord (som svordomar, konkurrentnamn eller "http://"). Recensioner som innehåller dessa ord blockeras automatiskt.

Pro-funktioner & Integrationer

Om du använder Maria Ratings Pro har du tillgång till en dedikerad svit av premiumkonfigurationer:

Mediauppladdning: Slå på eller av uppladdning av kundfoton och videor. Du kan ställa in maximalt antal filer som tillåts per recension och begränsa den maximala filstorleken (i MB) för att spara serverutrymme.
Flera bedömningskriterier: Istället för bara ett övergripande stjärnbetyg kan du definiera anpassade mätvärden (t.ex. Kvalitet, Värde och Frakthastighet) och be kunder att betygsätta varje enskilt.
Rich Text-redigerare: Ersätter den vanliga textrutan med en vacker WYSIWYG-redigerare, vilket gör att dina recensenter kan använda fetstil, kursiv stil och formaterad text.
Användbarhetsröstning: Aktivera gemenskapsengagemang genom att låta webbplatsbesökare rösta om en recension var till hjälp eller inte.
Verifierade märken: Visa en officiell "Verifierad"-bock bredvid recensenter som har slutfört e-postverifiering.
SEO Schema (JSON-LD): Injicera automatiskt strukturerad data på dina webbsidor så att Google och andra sökmotorer kan visa aggregerade stjärnbetyg direkt i sökresultaten, vilket ökar din klickfrekvens.
CAPTCHA-konfiguration: Välj Google reCAPTCHA v3 eller Cloudflare Turnstile för att blockera bots tyst utan irriterande bildpussel. Ange din Site Key och Secret Key som tillhandahålls av tjänsten för att aktivera den.
SMTP E-postinställningar: Ange dina SMTP-uppgifter (Värd, Port, Användarnamn, Lösenord, Kryptering) för att tillförlitligt skicka verifieringsmejl till användare.
Admin-notiser: Skicka automatiskt en e-postvarning till din inkorg så fort en ny recension har skickats så att du kan moderera den snabbt.
E-postverifiering (Double Opt-in): För att förhindra falska recensioner kan du tvinga användare att verifiera sina e-postadresser. Användare kommer att få en automatisk e-postlänk som de måste klicka på innan deras recension markeras för moderering.

7. Säkerhetsrekommendationer

Innan du lanserar ditt recensionssystem för allmänheten, vänligen säkerställ att följande säkerhetsåtgärder är på plats:

Tillåtna ursprung: I dina admininställningar, definiera uttryckligen de domännamn (t.ex. https://dinwebbplats.se) som tillåts skicka in recensioner. Använd inte jokertecknet * i en produktionsmiljö.
Skydda JSON-lagring: Om du använder JSON-lagring istället för MySQL måste du blockera direkt webbåtkomst till storage/-katalogen för att förhindra dataläckor. Apache-användare är skyddade som standard via den medföljande .htaccess-filen. Om du använder Nginx eller IIS måste du konfigurera dina serverregler för att uttryckligen neka åtkomst till den här mappen.