Giter VIP home page Giter VIP logo

experience-manager-core-components.en's Introduction

Adobe Experience Manager Core Components Documentation

Core Components Documentation

This is the repository for Adobe Experience Manager Core Components documentation. This documentation covers the installation, authoring use, and how to customize the core components.

Your contributions to the documentation are welcome. Please see the following resources:

  • contributing.md For an overview of how to contribute to the documentation.
  • guidelines.md For an overview on what is expected in contributions and how to compose your documentation contributions.
  • code-of-conduct.md For an overview of the standards of behavior we expect as you contribute to this documentation project.

Core Components Repository

The Adobe Experience Manager Core Components themselves are maintained as a project in a separate repository. Please check out that project if you need technical/developer documentation on the components, wish to contribute to the components themselves, or need to file an issue with the functionality or features of the core components.

experience-manager-core-components.en's People

Contributors

actinium15 avatar alvawb avatar bbringhu avatar blakefrei avatar bohnertchris avatar cziegeler avatar davidjgonzalez avatar gipaul avatar godanny86 avatar guillaumecarlino avatar jyotikas avatar lsantha avatar mhaack avatar mohiaror avatar raducotescu avatar raimans avatar richardhand avatar rickbrough avatar ruchita454401 avatar sarchiz avatar singhkh avatar tylerrush avatar vladbailescu avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

experience-manager-core-components.en's Issues

Update the instructions to be more detailed

Issue in ./help/developing/data-layer/overview.md

Regarding https://docs.adobe.com/content/help/en/experience-manager-core-components/using/developing/data-layer/overview.html#installation-activation

See below #1 has more details

NEW Detailed:

  1. Create the following structure below the /conf node:
  • /conf//sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig
  • com.adobe.cq.wcm.core.components.internal.DataLayerConfig node type: nt:unstructured , sling:configs node type: sling:Folder
  1. Add a boolean property called enabled and set it to true .
  2. Add a sling:configRef property to the jcr:content node of your site below /content (e.g. /content//jcr:content ) and set it to /conf/ .

OLD :

  1. Create the following structure below the /conf node:
  • /conf//sling:configs/com.adobe.cq.wcm.core.components.internal.DataLayerConfig
  • Node type: nt:unstructured
  1. Add a boolean property called enabled and set it to true .
  2. Add a sling:configRef property to the jcr:content node of your site below /content (e.g. /content//jcr:content ) and set it to /conf/ .

Also, please rephrase this sentence :

Once enabled, you can verify the activation by loading a page of the site outside of the editor. When you inspect the page you will see that the Adobe Client Data Layer is loaded.

Once enabled, validate the activation by loading a page in "View as Published" mode. When you inspect the page you will see that the Adobe Client Data Layer is loaded.

Accordion Component working in author, publish environment but fails in dispatcher

Hi,
we have enabled the core components and proxy the Accordion component on to the site. The Accordion works as expected in author and publish environment but fails in dispatcher. The accordion component rte field doesn't expand. There is no trace of errors either in dispatcher or console.log.
Link to the dispatcher : http://qaweb.nonprodaem.cnb.com/content/cnbcom/en/campaigns/test/awareness-demo.html

Publisher working image:
accordion_publish

Test

Testing if the Jira automation works on this repo.

Missing links inside the "Sample Component Output" section for the Email Components + Compatible with Cloud Service question

I was looking at the Email Components documentation and saw that all of the "Sample Component Output" sections in the components (9 of them, the Page Component does not have the said section) are leading to 404s:

Affected Documentation Pages:

  1. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/container.html?lang=en
  2. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/title.html?lang=en
  3. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/text.html?lang=en
  4. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/image.html?lang=en
  5. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/button.html?lang=en
  6. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/teaser.html?lang=en
  7. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/experience-fragment.html?lang=en
  8. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/content-fragment.html?lang=en
  9. https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/components/segmentation.html?lang=en

The links that lead to 404s inside those pages are

  1. https://adobe.com/go/aem_cmp_library_email_container
  2. https://adobe.com/go/aem_cmp_library_email_title
  3. https://adobe.com/go/aem_cmp_library_email_text
  4. https://adobe.com/go/aem_cmp_library_email_image
  5. https://adobe.com/go/aem_cmp_library_email_button
  6. https://adobe.com/go/aem_cmp_library_email_teaser
  7. https://adobe.com/go/aem_cmp_library_email_xf
  8. https://adobe.com/go/aem_cmp_library_email_cf
  9. https://adobe.com/go/aem_cmp_library_email_segmentation

Also all the component pages seem to mention that the Email components are Compatible with AEM Cloud Service but in the
Introduction page it's mentioned that it's not: https://experienceleague.adobe.com/docs/experience-manager-core-components/using/email/introduction.html?lang=en

Unreadable image for the Post Form Data

Issue in ./help/components/forms/form-container.md
The image illustrating the Post Form Data dialog is barely readable, something is wrong in its resolution or JPEG quality. The other images on the same page look all good.

Test issue

This is a test with Saeed.

Issue in help/using/introduction.md

Integration in Adobe Launch not usable for business

Both data elements and rules require writing custom code.
That is usually not suitable for business people. Is there any better integration planned in Adobe Launch which would allow to just use the UI without coding for setting up tracking?

Issue in ./help/developing/data-layer/analytics-integration.md

Incorrect Module Descriptions

Issue in ./help/developing/archetype/using.md

Archetype 24 removed it.launcher and introduced ui.tests modules.

The documentation has been incorrectly updated to describe the ui.tests as Java tests - these are actually WebDriver.IO JavaScript tests.

The it.launcher module was renamed to ui.launcher instead of being removed from the list.

A new entry ui.tests is needed to provide context for that module, and the current entry should be renamed back to it.tests.

Update versions page to reflect 2.23.2 deployment in CS

Issue in ./help/versions.md

This page shows 2.22.12 as the latest Core release.

According to comments in SITES-14545 Jira story, 2.23.2 is deployed to CS. My testing in Sandboxes seems to confirm the same.

Please update the page to correctly identify the latest release in Cloud Service.

Archetype should handle hyphens or document should call out the constraint

Issue in ./help/developing/archetype/overview.md

This issue is applicable to both the links below

If you specify the groupId with a '-' in it, the projects gets created but the code fails in the build. It would be good if we handle this. Some options

  1. Project creation fails fast with the error that the group id is invalid.
  2. The hyphens in groupId field are replaced with . or _ or some other valid characters.
  3. documentation calls out the WARNING explicitly.

Anchor links does not work

Issue in ./help/components/button.md

Clicking on the Anchor links "configure dialog" and "design dialog" in the Usage section does not do anything.

Expected: Links should take the user to appropriate headings.

Update edit dialog screen shot

Issue in help/using/text.md

The screen shot of the edit dialog of the text component is out-of-date. Please update to include all edit option icons.

Wow! Awesome Documentation!

Issue in ./help/developing/success.md

Not an issue. I just wanna say I’m 3 days into learning AEM working with a React SPA and these docs are some of the best docs I’ve ever read.

Just the fact that the docs even talk about success and failpoints highlights the quality of these docs. Breadth alone is not inherently a good thing, but these docs have breadth of everything that is relevant to software developers.

This exceeded my expectations, and the effort that went into making the documentation / tutorials is much appreciated. Thanks.

y’all should make a blog post for engineers about your strategy for this.

Not able to use number element for ordering a content fragment list

Issue in ./help/components/content-fragment-list.md

Order By - Field of the content fragment model by which the list will be ordered
Only text fields (including numeric, date, and time) are selectable.

should be changed to:

Order By - Field of the content fragment model by which the list will be ordered
Only text fields,date, and time (excluding numeric) are selectable.

Date & time : adobe/aem-core-wcm-components#2376 - Fixed in 2.20.0
Number : adobe/aem-core-wcm-components#2396 - will be fixed in future release

Label: DocBugBlitz2023

Broken link to Adaptive Image Servlet

Issue in ./help/components/image.md

The link in the first tip to a discussion or page on the Adaptive Image Servlet appears to be broken. It look like it currently goes to a non-existant anchor in the same page.

Please see the document Adaptive Image Servlet for details on how it works.

ui.apps pom does not have embedded tags for the filevault-package-maven-plugin

ui.apps/pom.xml
The ui.apps pom (//ui.apps/pom.xml) provides the embedded tags for the filevault-package-maven-plugin. The embedded tags include the compiled core bundle as part of the ui.apps package and where it will be installed.

I don't see <embedded> in ui.apps/pom.xml, but I do see them in all/pom.xml.

Anchor Link to Build List Using Search Broken

Issue in help/using/list.md

The anchor link in the sidebar under On This Page > Edit Dialog > List Settings Tab > Search is broken. The href is pointing to "#search" which is an id on the wrapper div for that section, but it looks like CSS and possibly something more global is using the same id, which I'm guessing, is conflicting (who uses an id in a stylesheet anyway!? ;-) ). Possible solution would be to use a different id in the div wrapper and href.

As as side note, sidebar won't appear unless your viewport is > 1400px.

AEM WCM Core Component Zip Install Issue

The latest version of core components 2.8 zip package from https://github.com/adobe/aem-core-wcm-components/releases is giving the the following error.

java.io.IOException: Error while reading stream
at org.apache.jackrabbit.vault.packaging.impl.JcrPackageImpl.getPackage(JcrPackageImpl.java:312)
at org.apache.jackrabbit.vault.packaging.impl.JcrPackageImpl.getPackage(JcrPackageImpl.java:277)
at org.apache.jackrabbit.vault.packaging.impl.JcrPackageImpl.extract(JcrPackageImpl.java:376)
at org.apache.jackrabbit.vault.packaging.impl.JcrPackageImpl.extract(JcrPackageImpl.java:360)
at org.apache.jackrabbit.vault.packaging.impl.JcrPackageImpl.install(JcrPackageImpl.java:354)
at com.day.crx.packaging.impl.J2EEPackageManager.consoleInstall(J2EEPackageManager.java:352)
at com.day.crx.packaging.impl.J2EEPackageManager.doPost(J2EEPackageManager.java:190)
at com.day.crx.packaging.impl.PackageManagerServlet.doPost(PackageManagerServlet.java:127)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:644)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:725)
at org.apache.felix.http.base.internal.handler.ServletHandler.handle(ServletHandler.java:123)
at org.apache.felix.http.base.internal.dispatch.InvocationChain.doFilter(InvocationChain.java:86)
at com.adobe.granite.license.impl.LicenseCheckFilter.doFilter(LicenseCheckFilter.java:308)
at org.apache.felix.http.base.internal.handler.FilterHandler.handle(FilterHandler.java:142)
at org.apache.felix.http.base.internal.dispatch.InvocationChain.doFilter(InvocationChain.java:81)
at org.apache.sling.i18n.impl.I18NFilter.doFilter(I18NFilter.java:131)
at org.apache.felix.http.base.internal.handler.FilterHandler.handle(FilterHandler.java:142)
at org.apache.felix.http.base.internal.dispatch.InvocationChain.doFilter(InvocationChain.java:81)
at org.apache.felix.http.base.internal.dispatch.Dispatcher$1.doFilter(Dispatcher.java:146)
at org.apache.felix.http.base.internal.whiteboard.WhiteboardManager$2.doFilter(WhiteboardManager.java:1002)
at org.apache.sling.security.impl.ReferrerFilter.doFilter(ReferrerFilter.java:326)
at org.apache.felix.http.base.internal.handler.PreprocessorHandler.handle(PreprocessorHandler.java:136)
at org.apache.felix.http.base.internal.whiteboard.WhiteboardManager$2.doFilter(WhiteboardManager.java:1008)
at org.apache.felix.http.sslfilter.internal.SslFilter.doFilter(SslFilter.java:97)
at org.apache.felix.http.base.internal.handler.PreprocessorHandler.handle(PreprocessorHandler.java:136)
at org.apache.felix.http.base.internal.whiteboard.WhiteboardManager$2.doFilter(WhiteboardManager.java:1008)
at org.apache.felix.http.base.internal.whiteboard.WhiteboardManager.invokePreprocessors(WhiteboardManager.java:1012)
at org.apache.felix.http.base.internal.dispatch.Dispatcher.dispatch(Dispatcher.java:91)
at org.apache.felix.http.base.internal.dispatch.DispatcherServlet.service(DispatcherServlet.java:49)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:725)
at org.eclipse.jetty.servlet.ServletHolder.handle(ServletHolder.java:873)
at org.eclipse.jetty.servlet.ServletHandler.doHandle(ServletHandler.java:542)
at org.eclipse.jetty.server.handler.ScopedHandler.nextHandle(ScopedHandler.java:255)
at org.eclipse.jetty.server.session.SessionHandler.doHandle(SessionHandler.java:1701)
at org.eclipse.jetty.server.handler.ScopedHandler.nextHandle(ScopedHandler.java:255)
at org.eclipse.jetty.server.handler.ContextHandler.doHandle(ContextHandler.java:1345)
at org.eclipse.jetty.server.handler.ScopedHandler.nextScope(ScopedHandler.java:203)
at org.eclipse.jetty.servlet.ServletHandler.doScope(ServletHandler.java:480)
at org.eclipse.jetty.server.session.SessionHandler.doScope(SessionHandler.java:1668)
at org.eclipse.jetty.server.handler.ScopedHandler.nextScope(ScopedHandler.java:201)
at org.eclipse.jetty.server.handler.ContextHandler.doScope(ContextHandler.java:1247)
at org.eclipse.jetty.server.handler.ScopedHandler.handle(ScopedHandler.java:144)
at org.eclipse.jetty.server.handler.ContextHandlerCollection.handle(ContextHandlerCollection.java:220)
at org.eclipse.jetty.server.handler.HandlerWrapper.handle(HandlerWrapper.java:132)
at org.eclipse.jetty.server.Server.handle(Server.java:502)
at org.eclipse.jetty.server.HttpChannel.handle(HttpChannel.java:370)
at org.eclipse.jetty.server.HttpConnection.onFillable(HttpConnection.java:267)
at org.eclipse.jetty.io.AbstractConnection$ReadCallback.succeeded(AbstractConnection.java:305)
at org.eclipse.jetty.io.FillInterest.fillable(FillInterest.java:103)
at org.eclipse.jetty.io.ChannelEndPoint$2.run(ChannelEndPoint.java:117)
at org.eclipse.jetty.util.thread.strategy.EatWhatYouKill.runTask(EatWhatYouKill.java:333)
at org.eclipse.jetty.util.thread.strategy.EatWhatYouKill.doProduce(EatWhatYouKill.java:310)
at org.eclipse.jetty.util.thread.strategy.EatWhatYouKill.tryProduce(EatWhatYouKill.java:168)
at org.eclipse.jetty.util.thread.strategy.EatWhatYouKill.run(EatWhatYouKill.java:126)
at org.eclipse.jetty.util.thread.ReservedThreadExecutor$ReservedThread.run(ReservedThreadExecutor.java:366)
at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:765)
at org.eclipse.jetty.util.thread.QueuedThreadPool$2.run(QueuedThreadPool.java:683)
at java.lang.Thread.run(Unknown Source)
Caused by: java.util.zip.ZipException: invalid entry size (expected 0 but got 334961 bytes)
at java.util.zip.ZipInputStream.readEnd(Unknown Source)
at java.util.zip.ZipInputStream.read(Unknown Source)
at java.io.FilterInputStream.read(Unknown Source)
at org.apache.commons.io.IOUtils.copyLarge(IOUtils.java:2314)
at org.apache.commons.io.IOUtils.copy(IOUtils.java:2270)
at org.apache.commons.io.IOUtils.copyLarge(IOUtils.java:2291)
at org.apache.commons.io.IOUtils.copy(IOUtils.java:2246)
at org.apache.commons.io.IOUtils.toByteArray(IOUtils.java:765)
at org.apache.jackrabbit.vault.fs.io.MemoryArchive.run(MemoryArchive.java:91)
at org.apache.jackrabbit.vault.packaging.impl.JcrPackageImpl.getPackage(JcrPackageImpl.java:310)

However if we download from Maven Repository
https://repo1.maven.org/maven2/com/adobe/cq/core.wcm.components.all/2.8.0/ the package installs.

Update screenshot of edit dialog

Issue in help/using/text.md

The screenshot of the text component edit dialog is out-of-date. Please update so that it shows all of the edit option icons.

Core Components are not Compatible with Static Templates

Issue in help/using/using.md
Issue in help/using/authoring.md

The contributors to the Core Components project state that core components will not work with static templates, but the documentation specifically states that it would work for both. Please update the docs to reflect the current state of affairs.

See below issues describing that Static Templates are not supported:
adobe/aem-core-wcm-components#100
adobe/aem-core-wcm-components#551

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.