Tip: Open Guide (or Resource Centre) on a desired Step (or RC article).

Featured

Comments

15 comments

  • Avatar
    Howard Lio

    This is awesome Stefano D'Avascio! This going to be so helpful for the Community when building out our guides!

    0
    Comment actions Permalink
  • Avatar
    Carolynn Rodon

    This is great Stefano D'Avascio thanks so much for sharing! 

    0
    Comment actions Permalink
  • Avatar
    Lyndsay Farrar

    Awesome!! This is exactly what we are looking for. I'm not a developer either :) Stefano D'Avascio Can you provide a little more information or screenshots on where to enter this info in the Pendo Designer? We are trying to launch the Resource Center from the last step in a guide. I tried including it in a custom code block but it doesn't seem to work. Any help appreciated. Thanks!

    0
    Comment actions Permalink
  • Avatar
    Stefano D'Avascio

    Hi Lyndsay Farrar! Great to hear this is (hopefully) gonna help you!

    To answer you question, the JS snippet illustrated above (toggleGuide(guide,step)) should be added to your app main JS file or a separate JS file that gets loaded by default, if that makes sense?

    Below a basic HTML structure to explain where to place the JS snippet:

    <html>
    <head>
    [Your meta tags here]
    </head>
    <body>
    [Your app content]

    <script src="your-pendo-guide-snippet.js"></script> <-- place your snippet here
    </body>
    </html>

    NOTE: if instead, you wish to open the last step of a specific guide from different guide, you can embed the JS snippet within the JS tab of a code block.

     

    Looking forward to hear from you.

    Please do let me know if that wasn't clear!

    0
    Comment actions Permalink
  • Avatar
    Stefano D'Avascio

    Hey Lyndsay Farrar, I've just read again your problem (sorry).

    I've been testing the snippet again, and I've got a couple of questions for you:

    A. The Resource Centre has an ID, but the Article you want to open also has an ID, the URL looks like this
    Are you replacing the ID with the entire thing (articleID+@+resourceCentreID)?

    B. Is the Resource Centre Article live?

    0
    Comment actions Permalink
  • Avatar
    Lyndsay Farrar

    Thanks Stefano D'Avascio! Our Resource Center isn't live yet and we wanted to open the Resource Center without going directly to a specific article within it. We were exploring a few options, this being one of them. I think we landed on creating a new separate guide that targets the Resource Center badge. We followed this video https://youtu.be/nwOSWMInd1Y

    1
    Comment actions Permalink
  • Avatar
    Stefano D'Avascio

    Hey Lyndsay Farrar, yeah that's an alternative, but then your users will have to at least click once to open the RC.

    The method described in the post opens the RC on a specific article as well as its main view, you'd only need to use the RC ID instead of the article one.

    0
    Comment actions Permalink
  • Avatar
    Alexis Ordona

    Stefano D'Avascio Hello! I am trying to use your steps to open the Resource Center Article but I cannot find my ID. Do I need to open the actual module? I don't see my url change to include the ID. Thanks for your help!

    0
    Comment actions Permalink
  • Avatar
    Stefano D'Avascio

    Hello Alexis Ordona! You should see the ID within the URL navigating into your Pendo Resource Center.
    So going to Pendo and to your RC, the address bar should display the ID within the URL. Is that not happening to you?

    0
    Comment actions Permalink
  • Avatar
    Alexis Ordona

    Stefano D'Avascio Ah I think I got confused that this opens a particular module, not a specific Help Center article in the Resource Center. I see the module ID in the URL now. 

    0
    Comment actions Permalink
  • Avatar
    Stefano D'Avascio

    Alexis Ordona you should be able to target a specific module in the RC:

    - Open the RC module details https://share.getcloudapp.com/YEuP2ypR
    - Find the module ID in the browser address bar https://share.getcloudapp.com/qGuRWvvQ

    Check also the following
    - The module has to be live
    - The segment chosen may impact who sees this

    Hope that helps?

    0
    Comment actions Permalink
  • Avatar
    Brian Johnson

    Stefano D'Avascio great article, thanks for posting. I'm still pretty new to Pendo but this is exactly what I need for one of my use cases. I was able to get your code working to open the guide by ID, but it only opens to the first step and won't open to the step number (numerical value) called by the function. I'm calling the function from a tooltip that is targeted to the same element as the desired step (numerical value) in the guide I'm opening. I'm hoping to use this function so I don't have to duplicate steps from that element forward. Any ideas or suggestions?

    0
    Comment actions Permalink
  • Avatar
    Stefano D'Avascio

    Hi Brian Johnson! I'm glad to hear this article is being helpful!

    Before I start looking into it, I've got a question for you, are you entering the step number as a number or a string? If I remember correctly it should be just a number (e.g. 2 and not "2").

    0
    Comment actions Permalink
  • Avatar
    Brian Johnson

    Stefano D'Avascio I appreciate the help. It's definitely a number.  I used your HTML sample to keep it simple until it's working. Here is a copy:

    <button onclick="toggleGuide('EFQBdmekGXScCHbhom_Jbz2XUaM',6)"><b>Open Guide</b></button>

     

     

    0
    Comment actions Permalink
  • Avatar
    Stefano D'Avascio

    Hey Brian Johnson, sorry for the late reply.

    I would invite you to double check if everything is active:
    - Is the guide published?
    - Is the guide active?
    - Is the right segment?
    - Is the target element on the page?

    If all the questions above are checked, I found this interesting Pendo article for the debugger you may want to give it a go? https://support.pendo.io/hc/en-us/articles/360034229512-Why-is-my-Guide-not-displaying-

    0
    Comment actions Permalink

Please sign in to leave a comment.