[sepidpooy]

Hi,

I am looking to add some Interactive tutorials in the Group home-page. I have noticed CBox-theme uses Joyride and it works fine the user activity page. However, I am able to understand the logic and port the same functionality in the Group home page. Would you please let me know where do I need to add custom Joyride codes ?

 

Thanks

 

[Scott Voth]

Hi @sepidpooy –

Joyride has some pretty good documentation here –

http://zurb.com/playground/jquery-joyride-feature-tour-plugin

Not sure if you are aware.  It seems to require five steps, and they are described in pretty good detail.  Can you look at the way the theme developers are implementing it in CBOX and mimic for the group home page?

I have not actually delved into JoyRide myself – but maybe @bowe or @cbox_admin or some other member of this site can provide some insight on how to extend tutorials to other sections if this doesn’t work.

• This reply was modified 11 years, 9 months ago by Scott Voth.

[sepidpooy]

Hi @scottvoth

 

Thanks for your reply. Here is the result of my discovery and where exactly I stuck

• The joyride tour is working only on the activity page
• The joyride tooltips are defined and hooked to activity page elements in the following file: cbox-theme/engine/extensions/features/bp/tour/template-items.php
• The tooltips details including message is defined in: cbox-theme/engine/extensions/features/bp/tour/options.ini
•  The joyride engine has been started in the following php file: cbox-theme/engine/extensions/features/scripts/joyride/template.php

I have defined new tooltip on the activity page by adding tooltip code hooked to a activity page element. Basically I modified template-item.php and it works file. However, if I hook the tooltip code to an element in the Group main page, the tooltip does not show up.

 

Does anybody knows why the joyride only work on the activity page ?

 

[sepidpooy]

I have investigated more and find out that joyride engine is not started in the Group Home page. As I said before, the start joyride code is located in

cbox-theme/engine/extensions/features/scripts/joyride/template.php

How can I make sure this php file is executed with the Group Home page ?

[sepidpooy]

I manage to enable the joyride engine in the Group Home and fix the problem by changing this function

 

function cbox_theme_buddypress_tour()
{
if ( bp_is_activity_component()  && !bp_is_user() && is_user_logged_i
infinity_feature( ‘cbox-buddypress-tour’ );
}

into this one:

function cbox_theme_buddypress_tour()
{
if (( bp_is_group() || bp_is_activity_component() ) && !bp_is_user() && is_user_logged_i
infinity_feature( ‘cbox-buddypress-tour’ );
}

[Scott Voth]

@sepidpooy – Thanks for sharing what you learned.  I am sure it will be useful to others who want to use JoyRide to guide new users.  @bowe @cbox-admin – do you think it would be helpful to add this modification to the CBOX default theme?

[Bowe Frankema]

@sepidpooy & @scottvoth this is cool! I think it would be nice to add a guided tour to the Groups page. I recently also made a tour for the Members page (for a client) so that can be added as well. @sepidpooy could you maybe send me your modifications through a zip file (email them at bowe@presscrew.com)?

Thanks!

[sepidpooy]

@bowe Thanks for your interest. It would be a pleasure to do something in return of your favor. However, I am sure you are not interested on the way I implemented it now. I have moved all tooltips from activity page to the main group page. Therefore, in my case there is no tour in the activity case. I need to fix that first and then send it for you.

I have one question for you which might help me a lot to find a solution:

You said you have also made an additional tour for Members page before. How did you add new starting point of the tour in the template-items.php?

I have realized that the a tour can be started from only one starting point (page element). Therefore, I changed the starting point from an element in the activity page into an element ID in the group home page. As a result, my activity page does not have any tour any more.

 

Thanks

 

• This reply was modified 11 years, 9 months ago by sepidpooy.

[Matthew K Gold]

Are you using a child theme, @sepidpooy? If not, @bowe, can you say whether these changes will be wiped out the next time the theme is updated?

[sepidpooy]

I am not using child theme.

[Bowe Frankema]

@sepidpooy I’ll commit the code for the Members Tour to my CBOX Fork on GitHub (. You can then see how I’ve done it exactly https://github.com/BoweFrankema/cbox-theme. I’ll then advise you to create a CBOX Child Theme like @mkgold advised. Follow the tutorial here: https://commonsinabox.org/archives/3324

If you could then post the changes you made back to me, so I can include the group tour in the next version of CBOX as well. We would then have tours for the activity stream, the members page and the groups page. 🙂

[sepidpooy]

Thanks @bowe . Please let me know when you made those comments.

[Author]

Posts