Template structure & Overriding templates via a theme
Overview
Ultimate Member template files contain your site's membership panel's markup and template structure for frontend and HTML emails.
Template files can be found within the ultimate-member/templates directory.
When you open template files, you will notice they contain hooks that allow you to add/move content without needing to edit template files themselves. This method protects against upgrade issues, as the template files can be left completely untouched.
Since version 2.6.2, we have implemented a template versioning feature to help you with updating outdated templates and sync when you update with our plugins, please see this article.
How to edit files
Edit files in an upgrade-safe way using overrides. Copy the template into a directory within your theme named /ultimate-member keeping the file structure according to the Templates Map. The copied file will override the Ultimate Member default template file. Edit the copied file to change a layout.
Example: To override the member directory base template, copy the file wp-content/plugins/ultimate-member/templates/members.php to wp-content/themes/{active_theme}/ultimate-member/templates/members.php where {active_theme} is your active theme folder.
Use an FTP connection to copy and edit files on the site. You can set up an FTP connection through the site control panel provided by the hosting provider. You will need an FTP client on your computer. We recommend using FileZilla Client.
Warning: Do not edit template files within the core plugin itself as they are overwritten during the upgrade process and any customizations will be lost. We recommend using a child-theme, which hasn't dependencies with the official themes repo, so your custom files cannot be rewritten after a theme upgrade.
Tip: You must maintain the folder structure of the template file when overriding the template via Theme/Child-theme.If your theme is wp-content/themes/twenty-fourteen/ and you need to override the member directory template /wp-content/plugins/ultimate-member/templates/members.php, the directory should be wp-content/themes/twenty-fourteen/ultimate-member/templates/members.php
Templates Map
| |
||
|---|---|---|
| MailChimp | wp-content/themes/{active_theme}/ultimate-member/um-mailchimp/ |
account_email_newsletters.php |
| field.php | ||
| fieldset.php | ||
| fieldset_ch.php | ||
| form_subscribe.php | ||
| form_unsubscribe.php | ||
| Private Messages | wp-content/themes/{active_theme}/ultimate-member/um-messaging/ |
email/new_message.php |
| email/new_message_reminder.php | ||
| account_notification.php | ||
| account_privacy.php | ||
| button.php | ||
| conversation.php | ||
| conversations.php | ||
| emoji.php | ||
| message.php | ||
| myCRED | wp-content/themes/{active_theme}/ultimate-member/um-mycred/ |
account_points.php |
| badges.php | ||
| rank_bar.php | ||
| Notices | wp-content/themes/{active_theme}/ultimate-member/um-notices/ |
notice.php |
| shortcode.php | ||
| Real-Time Notifications | wp-content/themes/{active_theme}/ultimate-member/um-notifications/ |
account_webnotifications.php |
| feed.php | ||
| no-notifications.php | ||
| notifications.php | ||
| notifications-list.php | ||
| notifications_button.php | ||
| Online Users | wp-content/themes/{active_theme}/ultimate-member/um-online/ |
nobody.php |
| online.php | ||
| online-marker.php | ||
| online-text.php | ||
| Profile Completeness | wp-content/themes/{active_theme}/ultimate-member/um-profile-completeness/ |
completeness-bar.php |
| completeness-popup.php | ||
| widget.php | ||
| Google Recaptcha | wp-content/themes/{active_theme}/ultimate-member/um-recaptcha/ |
captcha.php |
| captcha_v3.php | ||
| User Reviews | wp-content/themes/{active_theme}/ultimate-member/um-reviews/ |
email/review_notice.php |
| member-rating.php | ||
| reply-add.php | ||
| reply-edit.php | ||
| reply-front-actions.php | ||
| reply-list.php | ||
| review-add.php | ||
| review-detail.php | ||
| review-edit.php | ||
| review-front-actions.php | ||
| review-list.php | ||
| review-my.php | ||
| review-none.php | ||
| review-overview.php | ||
| review-widget.php | ||
| Social Activity | wp-content/themes/{active_theme}/ultimate-member/templates/activity/ |
new-follow.php |
| new-gform.php | ||
| new-gform-submission.php | ||
| new-group.php | ||
| new-post.php | ||
| new-product.php | ||
| new-topic.php | ||
| new-user.php | ||
wp-content/themes/{active_theme}/ultimate-member/um-social-activity/ |
clone.php | |
| comment.php | ||
| comment-reply.php | ||
| comments.php | ||
| edit-post.php | ||
| likes.php | ||
| new.php | ||
| trending.php | ||
| user-wall.php | ||
| Social Login | wp-content/themes/{active_theme}/ultimate-member/um-social-login/ |
buttons.php |
| form.php | ||
| pre-loader-form.php | ||
| Stripe Account | wp-content/themes/{active_theme}/ultimate-member/um-stripe/account/ |
billings.php |
| Stripe Checkout | wp-content/themes/{active_theme}/ultimate-member/um-stripe/checkout/ |
order-details.php payment.php |
| Stripe Form Field | wp-content/themes/{active_theme}/ultimate-member/um-stripe/ |
field-multiple.php field-single.php |
| Terms & Conditions | wp-content/themes/{active_theme}/ultimate-member/um-terms-conditions/ |
um-terms-conditions-public-display.php |
| Unsplash | wp-content/themes/{active_theme}/ultimate-member/um-unsplash/ |
modal.php |
| photo_attribution.php | ||
| User Bookmarks | wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/buttons/ |
add.php |
| remove.php | ||
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/edit-folder/ |
form.php | |
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/folder-view/folder/ |
folder-info.php | |
| title.php | ||
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/folder-view/ |
add-folder.php | |
| folder.php | ||
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/single-folder/ |
bookmark-item.php | |
| dropdown.php | ||
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/profile/ |
bookmarks.php | |
| edit-folder.php | ||
| folder-view.php | ||
| single-folder.php | ||
wp-content/themes/{active_theme}/ultimate-member/um-user-bookmarks/ |
modal.php | |
| select-folder.php | ||
| User Locations | wp-content/themes/{active_theme}/ultimate-member/um-user-locations/ |
infowindow.php |
| map-shortcode.php | ||
| map.php | ||
| User Photos | wp-content/themes/{active_theme}/ultimate-member/um-user-photos/email/ |
new_album.php |
wp-content/themes/{active_theme}/ultimate-member/um-user-photos/modal/ |
add-album.php | |
| delete-album.php | ||
| delete-comment.php | ||
| edit-album.php | ||
| edit-comment.php | ||
| edit-image.php | ||
| likes.php | ||
| modal.php | ||
wp-content/themes/{active_theme}/ultimate-member/um-user-photos/social-activity/ |
new-album.php | |
wp-content/themes/{active_theme}/ultimate-member/um-user-photos/ |
album-block.php | |
| album-head.php | ||
| caption.php | ||
| comment.php | ||
| comment-form.php | ||
| comments.php | ||
| gallery.php | ||
| gallery-head.php | ||
| photos.php | ||
| single-album.php | ||
| User Tags | wp-content/themes/{active_theme}/ultimate-member/um-user-tags/ |
tags.php |
| tags-widget.php | ||
| Verified Users | wp-content/themes/{active_theme}/ultimate-member/um-verified-users/email/ |
verification_request.php |
| verified_account.php | ||
wp-content/themes/{active_theme}/ultimate-member/um-verified-users/ |
account_info.php | |
| profile_info.php | ||
| verified-account.php | ||
| Woocommerce | wp-content/themes/{active_theme}/ultimate-member/um-woocommerce/ |
my-purchases.php |
| order-popup.php | ||
| orders.php | ||
| product-reviews.php | ||
| subscription.php |