Upplevelsefragment experience-fragments

Grunderna the-basics

Ett Experience Fragment är en grupp med en eller flera komponenter, inklusive innehåll och layout, som kan refereras till på sidor.

En primär eller variant av Experience Fragment, eller båda, använder följande:

Eftersom det inte finns någon /libs/cq/experience-fragments/components/xfpage/xfpage.html återställs den till följande:

HTML rendering the-plain-html-rendition

Du kan använda väljaren .plain. i URL:en för att få åtkomst till den vanliga HTML-återgivningen.

Den här funktionen är tillgänglig från webbläsaren. Dess främsta syfte är dock att tillåta andra program (till exempel webbprogram från tredje part, anpassade mobilimplementeringar) att komma åt innehållet i Experience Fragment direkt, med enbart URL:en.

Den rena HTML-renderingen lägger till protokoll, värd och kontextsökväg till sökvägar som är:

Till exempel:

.../brooklyn-coat/master.plain.html

Väljaren för enkel återgivning använder en transformator i stället för ytterligare skript. Sling Rewriter används som transformator och konfigureras enligt följande:

Konfigurera generering av HTML-återgivning configuring-html-rendition-generation

HTML-återgivningen genereras med Sling Rewriter-pipelines. Pipelinen definieras på /libs/experience-fragments/config/rewriter/experiencefragments. HTML Transformer stöder följande alternativ:

Vi rekommenderar att du konfigurerar omskrivaren med en övertäckning. Se Övertäckningar

Sociala variationer social-variations

Sociala varianter kan publiceras på sociala medier (text och bild). I Adobe Experience Manager (AEM) kan dessa sociala varianter innehålla komponenter, till exempel textkomponenter och bildkomponenter.

Du kan ta den sociala postbilden och texten från vilken bild- eller textresurstyp som helst, på vilket djup som helst. Resurserna kan antingen komma från byggblocket eller layoutbehållaren.

Sociala variationer möjliggör också byggstenar och tar hänsyn till dem vid sociala åtgärder (i publiceringsmiljön).

För att kunna publicera rätt text och bild i sociala medier måste vissa konventioner respekteras om du utvecklar egna anpassade komponenter.

Följande egenskaper måste användas:

Endast komponenter som använder denna konvention beaktas.

Mallar för Experience Fragments templates-for-experience-fragments

När du utvecklar en ny mall för Experience Fragments kan du följa standardmetoderna för en redigerbar mall.

Om du vill skapa en Experience Fragment-mall som identifieras av guiden Skapa Experience Fragment måste du följa någon av dessa regeluppsättningar:

Komponenter för Experience Fragments components-for-experience-fragments

Utveckla komponenter för användning med/i Experience Fragments följer standardrutiner.

Den enda extra konfigurationen är att säkerställa att komponenterna tillåts i mallen. Den här funktionaliteten uppnås med innehållsprincipen.

Experience Fragment Link Rewriter Provider - HTML the-experience-fragment-link-rewriter-provider-html

I AEM kan du skapa Experience Fragments. An Experience Fragment:

Ett av användningsområdena för sådana grupper är att bädda in innehåll i kontaktpunkter från tredje part, som Adobe Target.

Omskrivning av standardlänk default-link-rewriting

Med funktionen Exportera till mål kan du:

Den här funktionen kan vara aktiverad på en författarinstans av AEM. Det kräver en giltig Adobe Target-konfiguration och konfigurationer för länkutökningen.

Länkutjämnaren används för att fastställa rätt URL:er som behövs när du skapar HTML-versionen av målerbjudandet, som sedan skickas till Adobe Target. Adobe Target kräver att alla länkar i ett Target HTML-erbjudande är tillgängliga för alla. Publicera Experience Fragment och eventuella resurser som länkarna refererar till innan du använder dem.

Som standard skickas en begäran till en anpassad Sling-väljare i AEM när du skapar ett HTML-erbjudande för mål. Den här väljaren kallas .nocloudconfigs.html. Som namnet antyder skapas en ren HTML-återgivning av ett Experience Fragment, men inte molnkonfigurationer (vilket skulle vara överflödig information).

När du har genererat HTML-sidan ändrar pipelinen Sling Rewriter utdata:

När du använder en körklar implementering räcker det med den process som beskrivs ovan för att generera målerbjudandet från Experience Fragment och sedan exportera det till Adobe Target. Det finns dock vissa användningsfall som inte tas med i den här processen, bland annat följande:

I dessa fall tillhandahåller AEM Länkskrivarens providergränssnitt.

Link Rewriter-providergränssnitt link-rewriter-provider-interface

För mer komplicerade fall, som inte täcks av standard, erbjuder AEM providergränssnittet Länkskrivare. Det här arbetsflödet är ett ConsumerType-gränssnitt som du kan implementera i dina paket som en tjänst. Den åsidosätter de ändringar AEM utför på interna länkar i ett HTML-erbjudande som återges från en Experience Fragment. Med det här gränssnittet kan du anpassa processen för att skriva om interna HTML-länkar efter företagets behov.

Exempel på användningsområden för implementering av det här gränssnittet som en tjänst är:

Länkskrivarens providergränssnitt ( ExperienceFragmentLinkRewriterProvider) är följande:

public interface ExperienceFragmentLinkRewriterProvider {

    String rewriteLink(String link, String tag, String attribute);

    boolean shouldRewrite(ExperienceFragmentVariation experienceFragment);

    int getPriority();

}

Så här använder du providergränssnittet Länkskrivare how-to-use-the-link-rewriter-provider-interface

Om du vill använda gränssnittet måste du först skapa ett paket som innehåller en ny tjänstkomponent som implementerar providergränssnittet för Länkskrivare.

Den här tjänsten används för att ansluta till Experience Fragment Export till Target-omskrivning för att få tillgång till de olika länkarna.

Exempel: ComponentService:

import com.adobe.cq.xf.ExperienceFragmentLinkRewriterProvider;
import com.adobe.cq.xf.ExperienceFragmentVariation;
import org.osgi.service.component.annotations.Service;
import org.osgi.service.component.annotations.Component;

@Component
@Service
public class GeneralLinkRewriter implements ExperienceFragmentLinkRewriterProvider {

    @Override
    public String rewriteLink(String link, String tag, String attribute) {
        return null;
    }

    @Override
    public boolean shouldRewrite(ExperienceFragmentVariation experienceFragment) {
        return false;
    }

    @Override
    public int getPriority() {
        return 0;
    }

}

För att tjänsten ska fungera finns det nu tre metoder som måste implementeras i tjänsten:

shouldRewrite shouldrewrite

Du måste ange för systemet om länkarna behöver skrivas om när du anropar Exportera till mål för en viss Experience Fragment-variation. Du kan göra den här implementeringen med följande metod:

shouldRewrite(ExperienceFragmentVariation experienceFragment);

Till exempel:

@Override
public boolean shouldRewrite(ExperienceFragmentVariation experienceFragment) {
    return experienceFragment.getPath().equals("/content/experience-fragment/master");
}

Den här metoden tar som parameter emot den Experience Fragment-variation som systemet Exportera till mål för närvarande skriver om.

I exemplet ovan vill du skriva om:

Systemet Exportera till mål ignorerar alla andra Experience Fragments som passerar genom det, och den här tjänsten påverkar dem inte.

rewriteLink rewritelink

För Experience Fragment-variationen som påverkas av omskrivningsprocessen fortsätter den att låta tjänsten hantera omskrivningen av länken. Varje gång en länk påträffas i den interna HTML anropas följande metod:

rewriteLink(String link, String tag, String attribute)

Som indata tar metoden emot parametrarna:

Om till exempel systemet Exportera till mål bearbetar det här elementet kan du definiera CSSInclude som:

<link rel="stylesheet" href="/etc.clientlibs/foundation/clientlibs/main.css" type="text/css">

Anropet till metoden rewriteLink() görs med följande parametrar:

rewriteLink(link="/etc.clientlibs/foundation/clientlibs/main.css", tag="link", attribute="href" )

När du skapar tjänsten kan du fatta beslut baserat på angivna indata och sedan skriva om länken i enlighet med detta.

Du vill till exempel ta bort /etc.clientlibs-delen av URL:en och lägga till rätt extern domän. Om du vill hålla det enkelt bör du tänka på att du har tillgång till en resurslösare för tjänsten, som i rewriteLinkExample2:

private ResourceResolver resolver;

private Externalizer externalizer;

@Override
public String rewriteLink(String link, String tag, String attribute) {

    // get the externalizer service
    externalizer = resolver.adaptTo(Externalizer.class);
    if(externalizer == null) {
        // if there was an error, then we do not modify the link
        return null;
    }

    // remove leading /etc.clientlibs from resource link before externalizing
    link = link.replaceAll("/etc.clientlibs", "");

    // considering that we configured our publish domain, we directly apply the publishLink() method
    link = externalizer.publishLink(resolver, link);

    return link;
}

Prioriteringar - getPriority priorities-getpriority

Du kan behöva flera tjänster för olika typer av Experience Fragments. Du kan också använda en allmän tjänst för att externalisera och mappa alla Experience Fragments. I dessa fall kan konflikter uppstå om vilken tjänst som ska användas, så AEM ger möjlighet att definiera prioritet för olika tjänster. Prioriteringarna anges med hjälp av metoden:

Den här metoden tillåter användning av flera tjänster där metoden shouldRewrite() returnerar true för samma Experience Fragment. Tjänsten som returnerar det högsta antalet från sin getPriority()-metod är den tjänst som hanterar Experience Fragment-variationen.

Du kan till exempel ha en GenericLinkRewriterProvider som hanterar den grundläggande mappningen för alla Experience Fragments och när metoden shouldRewrite() returnerar true för alla Experience Fragment Variations. För flera specifika Experience Fragments kanske du vill ha specialhantering, så i det här fallet kan du ange en SpecificLinkRewriterProvider som metoden shouldRewrite() bara returnerar true för vissa Experience Fragment-variationer. Om du vill vara säker på att SpecificLinkRewriterProvider har valts för att hantera dessa Experience Fragment-variationer måste det returnera ett högre tal i sin getPriority()-metod än GenericLinkRewriterProvider.