Applikationen uppdateras av administratören under fliken Inställningar → Uppdateringar. Uppdateringar hämtas från tillverkarens server. Nya versioner installeras med ett klick (autoinstallatör, oftast utan FTP). Via FTP laddas filer upp vid den första installationen av programmet; vid en uppdatering kan teknisk support behövas när servern inte tillåter applikationen att skriva över sina egna filer. Om det nerladdade paketet skulle sakna en autoinstallatör visar applikationen en instruktion för att ladda upp filerna via FTP.

Att hämta en uppdatering kräver en aktiv licens (samma som låser upp sparande i applikationen). Tillverkarens server tillhandahåller versionslistan bara för en nyckel som är kopplad till den här installationens domän. När uppdateringsrättigheten som är kopplad till nyckeln har löpt ut får knappen för den nya versionen statusen Blockerad, och anledningen visas under versionsnumret samt när du för muspekaren över knappen.

Vid en licens med uppdateringar fram till ett datum gäller versionens publiceringsdatum (visas för varje version i listan): licensen omfattar versioner publicerade fram till rättighetens slut, inte nyare. Programmet fortsätter fungera - du kan bara inte hämta nyare versioner förrän du förnyar rättigheten (ny nyckel från leverantören, se kapitlet om licensen). Det är bäst att installera den sista uppdateringen inom rättighetsperioden innan den löper ut: tillverkarens server tillhandahåller vanligtvis bara den senaste versionen, så efter det datumet kanske den äldre inte längre visas.

Automatisk kontroll och avisering

Applikationen kontrollerar själv om det finns uppdateringar - du behöver inte längre gå in i inställningarna varje gång:

  • efter inloggning (när du öppnar applikationen),
  • med jämna mellanrum, medan applikationen är öppen,
  • när du återvänder till webbläsarfliken (om det gått en stund sedan den senaste kontrollen).

När en ny version kommer ut ser administratören en kort avisering (”Uppdatering tillgänglig - version X.Y.Z är redo att installeras”) med en knapp Visa, som direkt öppnar Inställningar → Uppdateringar. Aviseringen visas en gång per version (den stör inte vid varje inloggning) - vid nästa version får du en ny.

Om den nya versionen inte går att installera (t.ex. har uppdateringsrättigheten löpt ut) säger aviseringen det rakt ut: ”Version X.Y.Z finns tillgänglig, men kan inte installeras: …” tillsammans med anledningen. När uppdateringar är otillgängliga på grund av licensnyckeln (ingen nyckel, nyckel som inte känns igen, återkallad, kopplad till en annan domän eller okänd för servern) får administratören en enda varning, Uppdateringar otillgängliga, med en förklaring - nästa varning kommer först när problemet har försvunnit och sedan återkommit.

Indikator för ny version

Oavsett aviseringen ser administratören, när en nyare version finns tillgänglig, en röd prick på kugghjulsikonen (⚙) i den övre menyn, och efter att ha öppnat inställningarna - samma prick bredvid fliken Uppdateringar. Pricken försvinner automatiskt efter att den senaste versionen installerats. Indikatorn (och aviseringen) syns endast för administratörer.

Kontrollera tillgängliga versioner

  1. Klicka på kugghjulsikonen (⚙) → fliken Uppdateringar.

Utvecklarversion. Om applikationen körs i utvecklarläge (kod direkt från repositoriet) är uppdateringskontrollen avstängd: det finns varken röd prick eller aviseringar, och fliken talar rakt ut om att du arbetar med en utvecklarversion.

  1. Klicka på Sök uppdateringar. Du ser:
    • Installerad version - versionen som körs på servern,
    • Kodversion - versionen av applikationens filer,
    • Tillgängliga versioner - en lista över nyare utgåvor med ändringslogg (changelog) för var och en.

Versioner installeras i tur och ordning - endast knappen för nästa version är aktiv. Följande versioner blir tillgängliga efter att den föregående laddats upp.

Task Manager: fliken Uppdateringar med en lista över versioner och en knapp för installation.
Fliken Uppdateringar: version på servern, nyare utgåvor och en lista med ändringar.

Hämta paket

  1. Klicka på Hämta vid den närmast tillgängliga versionen.
  2. En varning om säkerhetskopiering visas - innan uppdateringen, gör en säkerhetskopia av databasen och mappen för bilagor (uploads/). Bekräfta för att fortsätta.
  3. Servern hämtar paketet och verifierar dess kontrollsumma (SHA-256). Sedan beroende på pakettyp:
    • Paket med auto-installerare - knappen Installera visas (beskrivning nedan). Du behöver inte ladda upp något via FTP.
    • Paket för manuell uppladdning - webbläsaren sparar filen .zip på din dator (vid behov kan du ladda ner den igen med knappen Spara paket (.zip)) och visar FTP-instruktioner.

Installation med ett klick (autoinstallerare)

För versioner som stöder autoinstallation behöver du inte FTP:

  1. Klicka på Installera efter hämtningen.
  2. En förloppsindikator (”Installerar…”) visas med de olika stegen: databasmigrering → filkopiering → slutförande.
  3. Efter avslutad process ändras knappen till Uppdatera applikationen - klicka på den för att läsa in den nya versionen (du kan också uppdatera sidan med Ctrl/Cmd + Shift + R).

Installeraren rör inte dina data - den hoppar över includes/config.php, uploads/, storage/ och logs/, och utför själv eventuella databasmigreringar. Det är ändå värt att ha en säkerhetskopia (varning visas vid nedladdning).

Observera: förloppsindikatorn visar hela förloppet ”live” först när den installerade versionen redan innehåller den här funktionen. Vid installation från en äldre version kan förloppet visas i större steg.

Installation via FTP (paket utan autoinstallerare)

Om paketet inte stödjer autoinstallation visar applikationen en instruktion för manuell uppladdning:

  1. Ta en säkerhetskopia av databasen och mappen uploads/ (om du inte redan gjort det).
  2. Packa upp den hämtade .zip-filen.
  3. Anslut till webbhotellet via FTP och ladda upp paketets innehåll till applikationens katalog och skriv över de befintliga filerna.
  4. Skriv INTE över (behåll dina egna):
    • includes/config.php - konfiguration och hemligheter,
    • uploads/ - bilagor och avatarer,
    • storage/ - arbetsdata,
    • logs/ - loggar.
  5. Uppdatera applikationen i webbläsaren (Ctrl/Cmd + Shift + R) och klicka på Sök uppdateringar igen för att bekräfta det nya versionsnumret.

Om versionen innehåller ändringar i databasen anger den versionens instruktion (changelog/versionsanteckning) ytterligare steg. Om du är osäker, återställ först säkerhetskopian och kontakta leverantören.

Vanliga frågor

  • ”Det gick inte att ansluta till uppdateringsservern” - kontrollera internetanslutningen och om licensen är giltig. Versionslistan tillhandahålls bara för installationer med en giltig nyckel. Den tekniska beskrivningen av anslutningsfelet (t.ex. ”Could not resolve host…”) lägger programmet till inom parentes efter ordet ”detaljer” - användbart för hostingens tekniska support.
  • ”Du har den senaste versionen” - det finns ingen nyare utgåva än den installerade. Det här meddelandet visas bara när servern har godkänt nyckeln - vid ett nyckelproblem ser du ett av meddelandena nedan istället.
  • ”Den här installationen har ingen licensnyckel…” - ange nyckeln under Inställningar → Avancerat → Licens; utan den frågar applikationen inte ens servern om versioner.
  • ”Uppdateringsservern känner inte igen licensnyckeln…” - nyckelns signatur stämmer inte med tillverkarens server (skadad nyckel eller från en annan källa). Ange nyckeln du fått från leverantören eller kontakta leverantören.
  • ”Den här installationens licensnyckel finns inte i uppdateringsserverns databas…” - nyckeln är korrekt, men tillverkarens server känner inte till den. Leverantören måste registrera den eller utfärda en ny.
  • ”Licensnyckeln… har återkallats…” - leverantören har återkallat den här nyckeln (vanligtvis efter att en ny har utfärdats). Ange den nya nyckeln.
  • ”Licensnyckeln är kopplad till en annan domän…” - nyckeln utfärdades för en annan adress än den programmet körs på. Be leverantören om en nyckel för den här domänen.
  • ”Version X.Y.Z är tillgänglig, men kan inte installeras: din rätt till uppdateringar upphörde DD.MM.ÅÅÅÅ…” - versionen publicerades efter att din uppdateringsrätt gick ut. Programmet fortsätter att fungera; för att installera den behöver du förnya rätten (en ny nyckel från leverantören). Den äldre versionen från din period brukar listan då inte längre visa - leverantörens server erbjuder oftast bara den senaste utgåvan.
  • ”Servern saknar PHP-tillägget ”zip”…” - utan detta tillägg kan applikationen inte packa upp paketet. Aktivera det i hostingpanelen (PHP-inställningar → tillägg) och försök igen. Applikationen kontrollerar detta innan paketet hämtas.
  • Versionen ändrades inte efter uppladdningen - kontrollera att filerna hamnade i rätt katalog och uppdatera sidan med rensning av cacheminnet (Ctrl/Cmd + Shift + R).
  • Meddelande om skrivrättigheter (t.ex. ”Det gick inte att skriva över filen … (skrivrättigheter?)”) - servern tillåter inte applikationen att spara sina filer. Åtgärda behörigheterna för applikationens katalog i hostingpanelen eller via FTP och försök uppdatera igen. Migreringar som redan har körts kommer inte att köras igen.
  • ”Applikationsservern returnerade ett oväntat svar (HTTP …)” - programmet på din server avslutades med ett fel innan det hann svara (vid kontroll eller hämtning av uppdatering). Orsaken sparas i PHP:s felloggar på ditt webbhotell - skicka den till supporten.
  • Knappen ”Blockerad” - orsaken visas under versionsnumret (och när du håller muspekaren över knappen): antingen behöver en tidigare version installeras först, licensen omfattar inte längre denna uppdatering (t.ex. har rätten till uppdateringar gått ut), eller så saknar utgåvan en giltig utgivarsignatur.