How to Bookmark an Event and Add a Note                                  

In order to add a bookmark, a user needs to log in to WP Event Manager.

1. Log in to your account.

2. Visit the Event Detail Page. It will show a bookmark box at the top of the listing, as shown in the image below.

3. Click the Bookmark This Event button. This will open the Add Bookmark form.

4. Add a note for the bookmark, if required, and save it.

5. After bookmarking, you can check all the bookmarked events on the Events page configured in the Bookmark Settings.

How to Remove Bookmarks from an Event Detail Page from the Frontend

Users can remove bookmarks only from events that are already added to the list of bookmarked events.

1. Go to the Event Dashboard.

2. Click on the specific bookmarked event that you want to remove from the bookmark list.

3. Go to that event detail page. You will see the Remove Bookmark option.

4. Click on the Remove Bookmark option to remove the bookmark from the event.

Another Way to Remove a Bookmark  

You can also remove a bookmark from the bookmarked events table.

1. Go to the Event Dashboard.

2. Click on Bookmarks.

3. Here, you can view all the bookmarked events.

4. Go to the Action section of the specific event from which you want to remove the bookmark.

5. Click on the Delete icon.

Users can add or remove bookmarks from the table.

How to Get the List of All Bookmarked Events Using Shortcodes

To access the list of all bookmarked events using a shortcode, follow the steps below:

1. Create a new page by going to WP Admin >> Pages >> Add New.

2. Name the page Events.

3. Add the following shortcode inside the content area:
   

4. Publish the page.

It is recommended that you insert the shortcode into the Text view of the visual editor to ensure it gets formatted correctly.

The [event_manager_my_bookmarks] shortcode displays all the event listings that the user has bookmarked.

After creating the page with the shortcode, you need to select this page in the Bookmark Settings.

Bookmark Settings                                                                             

To access the Bookmark Settings section, follow these steps:

1. Go to WP Admin.

2. Click on Event Manager.

3. Select Settings.

4. Click on the Event Bookmark tab.

Here, you will get the following options:

Bookmarks Page Name  

Bookmarks Page Name is a dropdown menu that contains the available pages.

You need to select the page where you have added the [event_manager_my_bookmarks] shortcode.

Delete Data on Uninstall  

Enabling this option means your bookmarking data will be deleted once you uninstall the plugin.

Bookmarking Matchmaking Participants                                      

Event participants can easily bookmark the matches they are interested in using this addon.

To bookmark a matchmaking participant:

1. Go to the Matchmaking List on the frontend event dashboard.

2. Click on the Participants tab. This will display the list of all participants.

3. Each participant has a bookmark action icon.

4. Click the bookmark icon next to the participant you are interested in.

After bookmarking participants, users can view their bookmarked users on the bookmarks page configured in the Bookmark Settings.

Advanced: Managing Bookmark Button and Bookmark Form     

The bookmark form is hooked into the event page after the event meta place, as shown below:

add_action( 'single_event_listing_button_end', array( $this, 'bookmark_form' ) );

To remove it and move it to a different place, you can do it like this:

1. /**
2. * Move my bookmark message to the perfect place.
3. *
4. * Show my bookmark message after the button section. That way, we have hooked the 'single_event_listing_button_end' hook, and it will show after the button section.
5. * @param  array $steps
6. *
7. * @return array
8. *
9. * @since 1.0.0
10. */
11. 
    
12. function move_my_bookmark_events_message()
13. 
    
14. {
15.     global $event_manager_bookmarks;     
16.     if ( has_action( 'single_event_listing_button_end', array( $event_manager_bookmarks, 'bookmark_form' ) ) )
17. 
    
18.     {
19. 
    
20.        remove_action( 'single_event_listing_button_end', array( $event_manager_bookmarks, 'bookmark_form' ) );
21. 
    
22.     }     
23. 
    
24.     if ( has_action( 'single_event_listing_button_end', array( $event_manager_bookmarks, 'bookmark_form' ) ) )
25. 
    
26.     {
27. 
    
28.         remove_action( 'single_event_listing_button_end', array( $event_manager_bookmarks, 'bookmark_form' ) );
29. 
    
30.         add_action( 'single_event_listing_button_end', array( $event_manager_bookmarks, 'bookmark_form' ) );        
31. 
    
32.     }
33. 
    
34.     else
35. 
    
36.     {
37. 
    
38.        add_action( 'single_event_listing_button_end', array( $event_manager_bookmarks, 'bookmark_form' ) );
39. 
    
40.     }        
41. 
    
42. }
43. 
    
44. add_action( 'wp', 'move_my_bookmark_events_message', 12 );
45. In general, you can use your choice of custom hook to append the form to a different place.
46. global $event_manager_bookmarks;
47. 
    
48. add_action( 'your_custom_hook', array( $event_manager_bookmarks, 'bookmark_form' ) );

Advanced: Overriding/Customizing the Template Files                   

For overriding or customization, template files can be found in the wp-event-manager-bookmarks/templates/ directory.

To override a template file, follow the steps below:

1. First, create a directory named wp-event-manager-bookmarks under your theme folder.

2. Copy the template file to the /wp-content/yourtheme/wp-event-manager-bookmarks/ directory.

3. Your theme will use all the template files from the /wp-content/yourtheme/wp-event-manager-bookmarks/ directory instead of the plugin's template files located at /wp-content/plugins/wp-event-manager-bookmarks/.

The following template files are available:

• my-bookmarks.php: This template file lists the user's bookmarks.

• bookmark-form.php: This template file controls the bookmark form display on events and attendee pages.

• add-bookmark-success.php: This template file controls the layout of the success message displayed after a bookmark is added. You can override the default layout from this file.

• delete-bookmark-success.php: This template file controls the layout of the success message displayed after a bookmark is removed. You can override the default layout from this file.

• login-to-bookmark-form.php: This template file controls the behavior and layout shown when a user who is not logged in tries to bookmark someone. It displays a login button, which can be customized or overridden from this file.

• matchmaking-bookmarked-users.php: This template file controls the layout of the user list containing users who have bookmarked other users that match their preferences.