Installera AEM Sidekick
Sidbrytaren ger innehållsförfattarna ett verktygsfält med sammanhangsberoende alternativ så att de kan redigera, förhandsgranska och publicera sitt innehåll direkt från webbplatsens sidor.
I det här dokumentet beskrivs hur du installerar och konfigurerar sidosparken.
Installationsalternativ
Sidsparken är tillgänglig som ett webbläsartillägg i Chrome-baserade webbläsare och Safari och kan installeras på flera olika sätt.
- Använd sidosparkskonfiguratorn.
- Installera sidosparken manuellt på samma sätt som andra tillägg
- Om du inte kan installera ett webbläsartillägg, installera sidminiatyr.
Om du redan har installerat sidosparken och behöver hjälp med att använda den kan du läsa dokumentet Använda tillägget AEM Sidekick.
Använda Sidekick Configurator
Konfiguratorn känner av din webbläsare och vägleder dig genom installationsprocessen.
- Navigera till länken i Safari eller en Chrome-baserad webbläsare
https://www.aem.live/tools/sidekick/ - Ange URL:en till GitHub-databasen för ditt projekt och eventuellt ett namn för projektet och klicka på Gå.
- Sidinsparken stöder flera projekt och ger ett beskrivande namn som hjälper dig att hantera konfigurationerna.
- I det nya avsnittet Installera tillägget Sidekick och lägg till projektet som visas klickar du på Installera Sidekick-tillägg för Chrome eller Installera Sidekick-tillägg för Safari.
- Sidan öppnar sedan App Store- eller Chrome Web Store där du kan installera tillägget i enlighet med ditt operativsystem.
- Återgå till sidan med konfiguratorn och klicka på Lägg till projekt.
- Konfiguratorn lägger till projektet i tillägget. Du är nu klar att använda tillägget!
Om du har problem med att installera tillägget läser du instruktionerna i avsnittet Installera Sidekick manuellt.
Installera Sidekick manuellt
Krom
- Navigera till sidospartillägget i dialogrutan Chrome Web Store.
- Klicka på Lägg till i Chrome -knappen.
- Klicka Lägg till tillägg för att bekräfta installationen.
- Klicka på den nya Adobe Experience Cloud-ikonen bredvid Chrome-adressfältet och klicka på Fäst om du vill att den ska visas.
Safari
-
Navigera till sidospartillägget i dialogrutan App Store.
-
Klicka på Installera -knappen.
-
Aktivera tillägget.
-
Safari för datorer
- Öppna Safari.
- Gå till Inställningar.
- Klicka på Tillägg.
- Markera rutan bredvid sidespartillägget.
-
Mobile Safari
- Öppna inställningar
- Tryck på Safari
- Tryck sedan på Tillägg.
- Växla sidospartillägget.
-
-
Kontrollera att tillägget tillåts åtkomst till alla webbplatser.
-
Om ditt projekt kräver att du loggar in för att använda tillägget för sidspark måste du aktivera cookies från tredje part: Safari > Inställningar > Sekretess > avmarkera alternativet Förhindra spårning mellan webbplatser
Lägga till ditt projekt
Det finns flera olika sätt att lägga till projekt i sidosparktillägget:
1. Sidekick Configurator
- Se avsnittet Använda Sidekick Configurator.
2. Delnings-URL
- Navigera till en delnings-URL som börjar med
https://www.aem.live/tools/sidekick/?... - Klicka på den blå Lägg till projekt -knappen.
- Du kan också klicka på Adobe Experience Cloud-ikonen bredvid webbläsarens adressfält och välja Lägg till projekt på snabbmenyn.
- En dialogruta visas där du kan bekräfta åtgärden. Klicka OK för att fortsätta.
En kollega i projektet kan ge dig en delnings-URL. Se dokumentet Använda tillägget AEM Sidekick för mer information.
3. Projekt-URL (endast dator)
- Navigera till en projekt-URL med ett värdnamn som det här:
https://main–repo–owner.hlx.page/ - Klicka på Adobe Experience Cloud-ikonen bredvid webbläsarens adressfält och välj Lägg till projekt på snabbmenyn.
- En dialogruta visas där du kan bekräfta åtgärden. Klicka OK för att fortsätta.
4. GitHub-databas-URL (endast skrivbordet)
- Navigera till en GitHub-databas som börjar med
https://github.com/... - Klicka på Adobe Experience Cloud-ikonen bredvid webbläsarens adressfält och välj Lägg till projekt på snabbmenyn.
- En dialogruta visas där du kan bekräfta åtgärden. Klicka OK för att fortsätta.
5. Alternativsida
På alternativsidan visas alla projektkonfigurationer och du kan lägga till, redigera eller ta bort dem.
-
Gå till alternativsidan:
- Chrome: Högerklicka på Adobe Experience Cloud-ikonen bredvid adressfältet och välj Alternativ på snabbmenyn.
- Safari (skrivbord): Högerklicka på Adobe Experience Cloud-ikonen bredvid adressfältet och välj Hantera tillägg… I dialogrutan Tillägg klickar du på Inställningar.
- Safari (mobil): Öppna inställningar och tryck på Safari > Tillägg > AEM Sidekick > Tilläggsinställningar.
-
Lägg till en projektkonfiguration med någon av följande två metoder:
- Lägg till via delnings-URL: Projektkonfigurationen hämtas från parametrarna i delnings-URL:en.
- Lägg till manuellt: ange GitHub-databasens URL och andra valfria parametrar för projektet.
Om projektkonfigurationer
- Projektnamn: Ange projektnamnet här. Detta skulle ge projektkonfigurationen ett namn som gör det enkelt att identifiera i sidosparken. Detta är en valfri konfiguration.
- Databas-URL: Ange Github-databasen för ditt projekt här. Exempel: https://github.com/hlxsites/wknd.
- Bonustips: Du kan ange din databasgren här om du vill att din projektkod ska hämtas från den här databasgrenen när du öppnar den i webbläsaren. Exempel: https://github.com/hlxsites/wknd/tree/mybranch
- Innehålls-URL: Ange URL:en för projektets rotmapp i SharePoint-/GDrive-roten.
- Produktionsvärdnamn: Ange produktions-URL (domännamnet är projektets offentliga värdnamn). På så sätt är sidsparken tillgänglig i webbläsaren när du öppnar webbplatsen i produktionsdomänen. Det här är en valfri inställning.
Avancerad konfiguration
Utveckla anpassningar av Sidekick lokalt
- Testa projektkonfigurationen lokalt: Använd den här avancerade inställningen för att testa lokala anpassningar i sidsparken. Läs mer om Sidekick-anpassningar här.
- URL för lokal utveckling: Ange URL:en för den lokalt körda servern. Standardvärdet är http://localhost:3000
Lägg till anpassad auktorisering
För webbplatser som skyddas med autentisering på .page och .livekan du lägga till en auktoriseringstoken som läggs till i HTTP Authorization: header.
Detta kan användas för att testa API-nycklarna som används i ditt CDN och för att kontrollera att de har tillgång till origo. Det här alternativet används troligtvis bara av administrativ personal för installation och felsökning.
Installera bokmärkesboken för Sidekick
Om du inte kan installera ett tillägg i webbläsaren, eller om du använder en webbläsare som inte stöds av sidspartillägget, kan du använda ett bokmärkesdiagram.
A bookmarklet är ett webbläsarbokmärke eller en favorit som innehåller JavaScript-kommandon som lägger till nya funktioner i webbläsaren. I sidosparkens bokmärkesbok läggs funktionerna i sidosparken till utan att någon installation behövs, vilket kan vara användbart för vissa användare.
Eftersom sidospartillägget kommer ihåg om det är öppet eller stängt på en viss innehållssida rekommenderar Adobe att tillägget installeras om det är möjligt. Bokmarknaden måste alltid öppnas och stängas manuellt på dina innehållssidor.
Så här installerar du bokmärket:
- Navigera till länken i webbläsaren
https://www.aem.live/tools/sidekick/ - Ange URL:en till GitHub-databasen för ditt projekt och eventuellt ett namn för projektet och klicka på Gå.
- Sidinsparken stöder flera projekt och ger ett beskrivande namn som hjälper dig att hantera konfigurationerna.
- Ett nytt avsnitt anropades Installera Sidekick Bookmarklet för det här projektet visas på sidan tillsammans med en knapp.
- Dra knappen till bokmärkes- eller favoritverktygsfältet.
- Klicka på bokmärket i bokmärkes- eller favoritverktygsfältet för att växla det.
Använda tillägget Sidekick
Se dokumentet Använda AEM Sidekick för att lära dig hur man använder sidesparken.