Home Getting Started

Getting Started

Juliana Dias
By Juliana Dias
8 articles

Migrating from V1

WP Ultimo has switched from its original 1.x family of releases to the 2.x family of releases. WP Ultimo version 2.0 and up is a complete rewrite of the codebase, meaning that there's very little shared between the old version and the new one. For that reason, when upgrading from 1.x to 2.x, your data will need to be migrated to a format that the new versions can understand. Thankfully, WP Ultimo 2.0+ comes with a migrator built into the core that is capable of detecting data from the old version and converting it to the new format. This migration happens during the Setup Wizard of version 2.0+. This lesson covers how the migrator works, what to do in cases of failure, and how to troubleshoot issues that might arise during this process. IMPORTANT: Before you begin upgrading from version 1.x to version 2.0 please make sure that you create a backup of your site database First steps The first step is to download the plugin .zip file and install version 2.0 on your network admin dashboard. After you install and activate version 2.0, the system will automatically detect that your Multisite is running on the legacy version and you will see this message at the top of the plugin page. NOTE: If you have WP Ultimo 1.x installed on your Multisite, you'll have the option to replace the plugin with the version you've just downloaded. Please, go ahead and click to Replace current with uploaded. The next page will let you know what legacy add-ons you have installed along with version 1.x. It will have instructions on whether the version you are using is compatible with version 2.0 or if you need to install an upgraded version of the add-on after the migration. Message on the top of the plugins page: Thanks for updating to WP Ultimo version 2.0. There's a link below it that leads the user to the version upgrader. Then, there's a list of add-ons that need to be updated. Once you are ready to proceed, you can click the button that says Visit the Installer to finish the upgrade. Framed in red: button saying Visit the Installer to finish the upgrade It will then bring you to the installation wizard page with some welcome messages. You just need to click Get Started to move to the next page. Setup Wizard's welcoming page. Framed in red at the bottom-right corner: Get Started button. After clicking Get Started, it will redirect you to the Pre-install Checks_._ This will show you your System Information and WordPress installation and tell you if it meets WP Ultimo's requirements. Pre-install Checks page showing confirmation messages that the installation meets WP Ultimo's requirements. Framed on red, on the bottom-right corner: Go to the next step button. The next step is to key in your WP Ultimo license key and activate the plugin. This will ensure that all the features, including add-ons, will be available on your site. License activation page listing what the support includes and what it doesn't. There's a box on the bottom to insert the plugin's license. Framed in red, on the bottom-right corner: Agree and activate button. After putting in your key, click Agree & Activate. After license activation, you can begin the actual installation by clicking Install on the next page. This will automatically create the necessary files and database needed for version 2.0 to function. Installation page showing what will be updated in order to WP Ultimo to function. Framed in red, on the bottom-right: Install button Now, the migration The migrator has a built-in safety feature wherein it will check your entire multisite to make sure that all your WP Ultimo data can be migrated without any issues. Click the Run Check button to start the process. Migration page explaining it will run a check to see if all your data from v1 can be converted. Framed in red, on the bottom-right corner: Run check button After running the check, you have two possibilities: the result can be either with an error or without an error. With Error Should you get an error message, you will need to reach out to our support team so that they can assist you in fixing the error. Make sure you provide the error log when you create a ticket. You can download the log or you can click the link that says contact our support team. It will open the help widget on the right-hand side of your page with the fields pre-populated for you that include the error logs under the description. Since the system found an error, you won't be able to proceed to migrate to version 2.0. You can then roll back to version 1.x to resume running your network until the error is fixed. Without Error If the system doesn't find any error, you will see a success message and a Migrate button at the bottom that will allow you to proceed with the migration. On this page, you will be reminded to create a backup of your database before moving forward, which we strongly recommend. Hit Migrate if you already have a backup. Migration page showing a success message and a recommendation to create a backup. Framed in red, on the bottom-right corner: Migrate button And this is all it takes! You can either continue to run the Wizard setup to update your logo and other things on your network or start navigating your WP Ultimo version 2.0 menu and its new interface. Go ahead and have some fun.

Last updated on Oct 10, 2023

Installing WP Ultimo (v2)

IMPORTANT NOTE: This article refers to WP Ultimo version 2.x. NOTE: This tutorial assumes that you already have your WordPress Multisite installed and configured. To see how you can install and configure WP Multisite, take a look at this tutorial by WP Beginner. The time has come! You finally have everything you need to get started building your online business with WordPress Multisite and WP Ultimo. Now, how do you install WP Ultimo? Getting the plugin's .zip file After finishing your WP Ultimo purchase, you will receive an email with the .zip file of our plugin and your license key. Freemius email with WP Ultimo .zip file and your license key Keep in mind this download link expires after some time, so if you want to download WP Ultimo after the link expires, you would need to do it by signing into your Freemius account and downloading it from there. Remember to also have your license key ready, since you will need it to activate WP Ultimo. Where to find your license key You can find your License key on the email you received after the purchase and inside your Freemius account. Just click on the Licenses tab and your license will be shown there. How to install WP Ultimo After getting the file, go to your network Dashboard and access the Plugins page where you can manage all the plugins you have. Network Plugins page. The Add New, on the top-left of the page button is framed in red. There, click Add New and then, Upload Plugin. Choose the .zip file of WP Ultimo and click Install Now*.* You should receive a confirmation message. Right below this message click to Network Activate your plugin, since WP Ultimo is a multisite plugin and needs to be activated network-wide. That will redirect you to our Setup Wizard. NOTE: If you have WP Ultimo 1.x installed on your Multisite, you'll have the option to replace the plugin with the version you've just downloaded. Please, go ahead and click to Replace current with uploaded. Setup Wizard Here you are able to set up your network in a few minutes by clicking Get Started. This will redirect you to the Pre-Install Checks where you can find your System Information and WordPress installation. This will tell you if it meets WP Ultimo's requirements. If everything is ok, click to Go to the Next Step. The next step is to key in your WP Ultimo license key (that Freemius sent you by email or that you downloaded on your Freemius dashboard) and activate the plugin. This will ensure that all the features including add-ons will be available on your site. After putting in your key, click Agree & Activate_._ After license activation, you can start the actual installation by clicking Install on the next page. This will automatically create the necessary files and database for WP Ultimo to function. The next step is to configure basic settings like filling in your company information and default currency. After you set these parameters, click Continue to go to the next step. The following page will allow you to install predefined templates, products, etc. This will help you get started and serve as your guide to familiarize yourself with managing WP Ultimo features. And this is all it takes! You can click Finish and start navigating WP Ultimo from the left-hand side of your network Admin Dashboard. Go ahead and have some fun!

Last updated on Oct 16, 2023

Creating your First Subscription Product (v2)

IMPORTANT NOTE: This article is only for WP Ultimo version 2.x users. If you are using version 1.x, see this article. To start running your network and begin selling your services to potential users, you need to have different subscription options. How do you create these products? What are the types of products you can offer? In this article, we will cover everything you need to know about products. Product Type With WP Ultimo you can offer two categories of products to your clients: plans and add-ons (Order Bump). Add-ons can be divided into two types:packages and services. We will see their differences and particularities next. - Plans: the fundamental product of WP Ultimo. Your client can only have a membership if it’s attached to a plan. A plan provides your clients with one or more sites (it depends on the configurations of your plan) with the limitations you set on your product editing page. - Packages: add-ons that impact directly on WP Ultimo plans’ functionalities. They alter limitations or add new resources, plugins or themes to the original plan your client bought. For example, a basic plan might allow 1,000 visits per month and you can make available a package that extends this number to 10,000. - Services: add-ons that do not alter WP Ultimo’s functionalities. They are tasks that you will realize for your client in addition to the plan they bought. For example, your customer might buy a plan that allows for a single site and also pays for an extra service that will make this site design. Managing Products For many the Products tab in WP Ultimo (WP Ultimo > Products) can be equated with plans in a traditional hosting environment. Within WP Ultimo the Products tab defines the construct and limitations applicable to a specific product or service. Such constructs extend to product or service description, price, taxes, and permissions. This section will guide your understanding of this essential cornerstone of WP Ultimo. Adding Products Whether a plan, package, or service the entry point to defining a new item is via WP Ultimo > Products > Add Product. The interface contains two predominant sections. On the left are several tabs which assist with the definition of the product and on the right are a few sections to define the base price of the product, its active state, and product image. Description The base product information can be defined by supplying a product name and description. These identifiers are displayed wherever the product information is required such as plan and pricing selection, invoices, upgrades, and the like. Pricing Type On the right side of the interface, the base pricing can be defined. WP Ultimo supports three different pricing types. The paid option prompts the network administrator for information regarding the product’s price and billing frequency. Pricing The price component defines the base product price and billing interval. thus an example price of $29.99 with a setting of 1 month will bill $29.99 each month. Similarly, a price of $89.97 with a setting of 3 months will bill that amount each quarter. Billing Cycles The billing cycles section specifies the frequency of the aforementioned billing interval and is generally understood in the light of contracts or fixed terms. For example, a product price of $29.99 with an interval of 1 month and 12 billing cycles would bill $29.99 per month for the product over the succeeding 12 months. In other words, such a setting would establish a fixed-price term of $29.99 per month for 12 months and then cease billing. Trial Period Enabling the offer trial toggle allows the network administrator to define a trial period for the product. During the trial period, customers are free to use the product and will not be billed until the trial period has been exhausted. Setup Fee You can also apply a setup fee to you plan. This means that your client will pay an extra amount on the first charge (in addition to the price plan) that corresponds to the fee you defined in this section. Active The active toggle effectively defines whether the product is available to customers for new sign-ups. If there are existing customers on this plan setting the toggle to its disabled state effectively grandfathers the plan removing it from future sign-ups. Existing customers on the plan will continue to be billed until they are transitioned to a new plan or removed from the plan. Product Image The Upload Image button allows the network administrator to make use of the media library to select or upload a product image. Delete The Delete Product button deletes the product from the system. It appears once the product is published. Unlike other deletions, the product is not placed in any trash state. Thus once deleted the action is irreversible. Product Options Once the base-level product information is defined, the product options aid the network administrator to further define the specific attributes of the product. General The General tab defines the general attributes of the product not applicable to any of the other product-specific tabs. The self-explanatory product slug defines the slug with which the product is identified in URLs and other areas of WP Ultimo. WP Ultimo supports several product types namely Plan, Package, and Service. The Product Options tabs are dynamically adjusted depending on the product type specified. The Customer Role specifies the role that the customer is assigned when the site is created. Typically for most network administrators, this will be the WP Ultimo default or Administrator. The WP Ultimo default role can be set in WP Ultimo > Settings > Login & Registration. Up & Downgrades This tab specifies the upgrade and downgrade paths available to a customer within their specific tier. To understand this concept consider an example where a niche WP Ultimo installation provides learning management solutions to its customers. To achieve this three plans (Basic, Plus, and Premium) are defined and specific plugins are activated for each plan (see later in this section for instructions on how to activate plugins). If the WP Ultimo installation also services business websites or eCommerce websites those plans may require different plugins to be installed and activated. To this extent, it would be undesirable and problematic to allow eLearning customers to transition to eCommerce plans as these plans, pricing, and limitations may not be an appropriate fit. Thus to restrict the path of the customer and to prevent incidents the network administrator can define a plan group and within that group specify the plans the customer can transition to. To define a plan group specify the compatible plans within the plan group list. The product order determines how the plans are ordered and displayed from the lowest to the highest. WP Ultimo also includes an order bump feature where appropriate add-on products and services can be added to plans. These are offered to the customer as additional items which can be added to plans on checkout or during an upgrade. Price Variations Price variations allow the network administrator to specify alternate pricing tiers depending on duration. This setting makes it possible for 3 months, 6 months, or annual pricing tiers to be established or any other duration and frequency as determined by the use case. To establish price variations, set the enable price variations toggle to active and click the Add new Price Variation button. To enter a variation, set the duration, period, and price of the variation. Additional variations can be entered by clicking the button again. Taxes The Taxes tab aligns with the tax settings specified in WP Ultimo > Settings > Taxes and more specifically the tax rates defined. To enable taxes and define applicable tax rates please see the documentation at WP Ultimo: Settings In a previous example, we defined a local tax rate of 7.25% applicable to customers in California (United States of America). Once the tax rate is defined in WP Ultimo > Settings > Manage Tax Rates it is selectable at the product level. To indicate that a product is a taxable item, set the Is Taxable toggle to active and select the applicable tax rate from the Tax Category dropdown. Site Templates In essence, site templates are complete WordPress websites that are cloned to a customer’s site at the start of their subscription. The network administrator creates and configures the template site as a regular WordPress site with activated and configured themes, plugins, and content. The template site is cloned verbatim to the customer. This tab allows the network administrator to specify the behavior of site templates upon a new subscription. To make use of site templates, set the allow site templates toggle to its active state. The site template selection mode defines the behavior of site templates during the subscription process. The D efault setting follows the steps in the checkout form. If the network administrator has defined a template selection step in the checkout process and the step has been defined with templates this setting will honor the directives established in the checkout step. Specifying A ssign Site Template forces the selection of the specified template. Consequently, any template selection steps in the checkout process are removed. Lastly, C hoose Available Site Templates overrides the templates specified in the checkout step with the templates selected in this setting. A pre-selected template can also be defined to aid the customer in selection. Ultimately if the network administrator desires template selection to occur in the checkout steps the setting of ‘default‘ will suffice. Alternatively to remove and lock template selection and delegate the selection to the plan settings the ‘assign new template’ or ‘choose available site templates’ options may be desirable. Sites The Sites tab is part of WP Ultimo’s limitations functionality. This setting specifies the maximum number of sites a customer can create under their membership. To enable the limitation, set the limit sites toggle to its active state and specify the maximum number of sites in the site allowance field. Visits The Visits tab is a further part of WP Ultimo’s limitations system. This setting allows for the accounting and subsequent throttling of unique visitors to a customer’s site. From a marketing perspective network, administrators can make use of this setting as a means to encourage customers to upgrade their plan once limits are reached. This setting can also assist the network administrator to curb and prevent excessive traffic to sites to preserve system resources. To make use of this feature, set the limit unique visits toggle to its active state and specify the maximum number of unique visitors in the unique visits quota field. Once this limit is reached WP Ultimo will cease to serve the customer’s site instead of displaying a message to indicate that limits have been exceeded. Users WP Ultimo’s ‘Users’ limitations allow the network administrator to impose limits on the number of users that can be created and assigned to roles. To enable the limitations feature, set the limit user toggle to its active state by sliding it to the right. Next for each role to be limited, set the toggle next to it to an active state and define the maximum upper limit in the appropriate field. Post Types The Post Types tab allows the network administrator to impose granular limits on the extensive array of post types within WordPress. Due to the construction of WordPress, posts and post types are a significant component of its core functionality, and thus WP Ultimo’s limitations system is designed to assist the network administrator in establishing and maintaining limits. To enable this limits subsystem, set the limit post types toggle to its active state by sliding it to the right. Next, for each post type to be limited, toggle it on by sliding it to the right and specifying the maximum upper limit in the appropriate field. Disk Space The Disk Space tab allows network administrators to restrict the space consumed by customers. Typically in a WordPress multisite the core files are shared amongst all sites and individual directories created for media files and uploads to which these settings and limitations apply. To enable the disk usage limitation, set the limit disk size per site toggle to its active state by sliding it to the right. Next, specify the maximum upper limit in megabytes in the disk space allowance field. Custom Domain By toggling this option you can allow custom domains on this plan specifically. Themes The Themes tab within the product options allows the network administrator to make themes available to customers for selection and to optionally force the state of the theme. Note: For themes to be made available to customers they must be network enabled by the network administrator. The visibility option defines whether or not this theme is visible to the customer when viewing their Appearance > Themes tab within their site. Setting this option to Hidden removes the theme from view and thus restricts the ability to select and activate it. The behavior selection allows the network administrator to define the state of the theme upon the creation of the customer site. In the A vailable state the theme is made available to the customer for self-activation. Conversely, the Not Available state removes from the customer the ability to activate the theme. Lastly, the Force Activate option forces the selection and activation of the theme thus setting it as default upon site creation. Plugins Similar to the Themes tab, WP Ultimo allows the network administrator to define the visibility of plugins to customers as well as their state upon the creation of a new site. The visibility drop-down allows for the plugin to either be visible or hidden from the customer when viewed on their site through the Plugins menu option. The network administrator can further manipulate the behavior of the plugins by making use of the options in the behavior drop-down. The Default selection honors the plugin state defined in the site template selected by the customer. Thus plugins that are activated within the template will remain activated when the template is cloned to the customer’s site. The Force Activate places the plugin in an active state upon site creation and conversely the Force Inactivate deactivates the plugin upon site creation. In both of these circumstances, the plugin’s state can manually be altered by the customer through their WordPress Plugins menu. The Force Activate & Lock setting operates similarly but prevents the plugin state from being altered by the customer. Thus a setting of Force Activate and Lock will force the plugin into its active state and prevent the customer from deactivating it. Similarly, the Force Inactivate & Lock setting will force the plugin to its inactive state and prevent the user from activating the plugin. The network administrator may wish to consider the Force Activate & Lock and Force Inactivate & Lock settings in conjunction with site templates as plugins and plugin states within the templates may be impacted by these settings if selected. Reset Limitations The Reset Limitations tab resets all custom limits defined on the product. To reset limitations click on the reset limitations button. To confirm the action slide the confirm reset toggle to its active state on the right and click the reset limitations button. Legacy Options The Legacy Options tab observes certain options and behaviors defined in WP Ultimo 1.x. These options are offered for compatibility and ease of transition and will be deprecated in future releases. Edit, Duplicate, or Delete Product Existing products can be edited, duplicated or deleted by navigating to WP Ultimo > Products and hovering over the existing product name.

Last updated on Oct 16, 2023

Getting Paid (v2)

IMPORTANT NOTE: This article refers to WP Ultimo version 2.x. WP Ultimo has a built-in membership and billing system. For our billing system to function, we have integrated the most common payment gateways used in e-commerce. The default payment gateways in WP Ultimo are Stripe, PayPal, and Manual Payment. You can also use WooCommerce, GoCardless and Payfast to receive payments by installing their respective add-ons. Basic Settings You can configure any of these payment gateways under WP Ultimo payment settings. You can find it by going to WP Ultimo menu > Settings > Payments. Before you setup your payment gateway, please take a look at the basic payment settings you can configure: Force auto-rene w: This will make sure that the payment will automatically recur at the end of every billing cycle depending on the billing frequency the user selected. Allow trials without payment method: With this option enabled your client won't have to add any financial information during the registration process. This will only be required once the trial period expires. Send invoice on payment confirmation: This gives you an option whether or not to send an invoice after payment. Note that users will have access to their payment history under their subsite dashboard. This option doesn't apply to the Manual Gateway. Invoice numbering scheme: Here, you can select either a payment reference code or a sequential number scheme. If you choose to use a payment reference code for your invoices, you don't need to configure anything. If you choose to use a sequential number scheme, you will need to configure the next invoice number (This number will be used as the invoice number for the next invoice generated on the system. It is incremented by one every time a new invoice is created. You can change it and save it to reset the invoice sequential number to a specific value) and the invoice number prefix. Where to find the gateways: You can setup the payment gateways on the same page ( WP Ultimo > Settings > Payments). Right below active payment gateways, you will be able to see: Stripe, Stripe Checkout, PayPal and Manual. We have a dedicated article for each payment gateway that will guide you through the steps of setting it up which you can find on the links below. Setting up the Stripe gateway Setting up the PayPal gateway Setting up manual payments Now, if you want to use WooCommerce, GoCardless or Payfast as your payment gateway, you will need to install and configure their add-ons. How to install the WooCommerce add-on: We understand that Stripe and PayPal are not available in some countries which limit or hinders WP Ultimo users from effectively using our plugin. So we created an add-on to integrate WooCommerce, which is a very popular e-commerce plugin. Developers around the world created add-ons to integrate different payment gateways to it. We took advantage of this to extend the payment gateways you can use with the WP Ultimo billing system. IMPORTANT: WP Ultimo: WooCommerce Integration requires WooCommerce to be activated at least on your main site. First, please go to the add-ons page. You can find it by going to WP Ultimo > Settings. You should see the Add-ons table. Click on Check our Add-ons. After clicking on Check our Add-ons, you will be redirected to the add-ons page. Here you can find all WP Ultimo add-ons. Click on the WP Ultimo: WooCommerce Integration add-on. A window will pop up with the add-on details. Just click on Install Now. After the installation is done, you will be redirected to the plugins page. Here, just click on Network Activate and the WooCommerce add-on will be activated on your network. After activating it, if you still don't have the WooCommerce plugin installed and activated on your website, you will receive a reminder. To read more about the WooCommerce Integration add-on, click here. How to install the GoCardless add-on: The steps to install the GoCardless add-on are pretty much the same as the WooCommerce add-on. Please go to the add-ons page and select the WP Ultimo: GoCardless Gateway add-on. The add-on window will pop up. Click on Install Now. After the installation is done, you will be redirected to the plugins page. Here, just click on Network Activate and the GoCardless add-on will be activated on your network. To learn how to get started with the GoCardless gateway, read this article. How to install the Payfast add-on: Go to the add-ons page and select the WP Ultimo: Payfast Gateway add-on. The add-on window will pop up. Click on Install Now. After the installation is done, you will be redirected to the plugins page. Here, just click on Network Activate and the Payfast add-on will be activated on your network.

Last updated on Oct 16, 2023

Site Templates (v2)

NOTE: This article refers to WP Ultimo version 2.x. If you are using version 1.x, see this article. Our goal when creating a premium network with WP Ultimo is to automate as many processes as possible while giving our clients flexibility and different options to choose from when creating their websites. One easy way to achieve this balance is to make use of the WP Ultimo Site Templates feature. What is a Site Template? As the name suggests, a Site Template is a boilerplate site that can be used as a base when creating new sites in your network. This means you can create a base site, activate different plugins, set an active theme, and customize it in any way you like. Then, when your customer creates a new account, instead of getting a default WordPress site with no meaningful content inside it, they will get a copy of your base site with all the customizations and contents already in place. That sounds awesome, but how do I create a new site template? It is as simple as it can possibly get. Creating and Editing a new Site Template Site Templates are just normal sites on your network. To create a new template you can simply go to Network Admin > WP Ultimo > Sites > Add Site. add site template This will open a modal window where it will ask for the Site title, Site Domain/path, and Site type. Under the Site Type drop-down field make sure that you select Site Template*.* Add site template modal At the bottom of the form, you will notice a Copy Site toggle switch. This will allow you to create a new site template based on an existing site template as your starting point to help you save time instead of creating a site template from scratch. Add site template modal 2 Customizing the contents of a Site Template To customize your site template, simply navigate to its dashboard panel and make the changes you need. You can create new posts, pages, activate plugins and change the active theme. You can even go to the Customizer and change all sorts of customization options. All of that data will be copied over when a customer creates a new site based on that Site Template. Advanced Options If you know your way around some custom coding, you can make use of our Search and Replace API to automatically replace information on the new site after its creation. This is useful for things like replacing company names on an About page, replacing the contact email on the Contact page, etc. Using Site Templates Ok, so you created a bunch of different Site Templates with different designs, themes and settings. How do you make them useful on your network now? Basically, there are two approaches you can use now (not simultaneously): - Attaching one Site Template to each of your Plans OR - Allowing your clients to choose the site templates themselves during sign-up. Mode 1: Assign Site Template In this mode, your clients won’t be able to choose a template when they create an account, but rather you will define which template should be used on each of your Plans. To do that, you’ll need to go to WP Ultimo > Products > Edit. Assign site template This will bring you to the Edit Product page. Under the Product Options section, find the Site template tab and select the Assign Site Template option from the drop-down field. This will bring up the list of site templates available and it will allow you to select only one site template dedicated to the product. Assign site template Mode 2: Choose Available Site Template In this mode, you’ll give your clients a choice during the sign-up process. They will be able to select from different site templates you define under the product settings. You have an option to limit the site template they can choose from under the selected product. This will allow you to have different sets of site templates under each product which is ideal to highlight different functions and features for a higher-priced product. On the Edit Product page. Under the Product Options section, find the Site template tab and select the Choose Available Site Template option from the drop-down field. This will bring up the list of site templates available and it will allow you to select the site template you wish to be available. You can do this by choosing its Behavior: Available if you want the site template to be included on the list. Not Available if you want the site template not to show as an option. And Pre-selected if you wish one of the site templates listed to be the default selected. Assign site template Default Mode: Site template selection on the Checkout form If you wish all your site templates to be available during the registration, or maybe do not prefer doing extra work of assigning or specifying site templates under each product you create. Then you can simply set the site template selection under your Checkout Form. To do this, you just need to go to WP Ultimo > Checkout Forms. Then click Edit under the form you wish to configure. Assign site template This will bring up the Edit Checkout Form page. Find the Template Selection field and click Edit under it. Assign site template A modal window will appear. Under the Template Sites field you can select and list down all the site templates you wish to be available during registration. The site templates you specify from here will be available regardless of whatever product the user selected. Assign site template Site Template Options There are other site templates functions available that you can turn on or off under WP Ultimo settings. Site template option Allow Template Switching Enabling this option will allow your clients to switch the template they choose during the sign-up process after the account and site is created. This is useful from a client’s point of view since it allows them to re-select a template if they later find out their original choice was not the best one for their particular needs. Allow Users to use their Site as templates Since subsite users spent time building and designing their own site, they may want to clone and use it as one of the site templates available upon creating another subsite on your network. This option will allow them to achieve that. Copy Media on Template Duplication Checking this option will copy the media uploaded on the template site to the newly created site. This can be overridden on each of the plans. Prevent Search Engines from indexing Site Templates Site templates as discussed in this article are boilerplate but still part of your network which means that it is still available for search engines to find. This option will allow you to hide the site templates so that search engines can index them. Pre-populating Site Templates with auto search-and-replace One of the most powerful features of WP Ultimo is the ability to add arbitrary text, color, and select fields onto the registration form. Once we have that data captured, we can use it to pre-populate the content in certain parts of the site template selected. Then, when the new site is being published, WP Ultimo will replace the placeholders with the actual information entered during registration. For example, if you wish to get your end-user's company name during registration and automatically put the company name on the home page. On your template site home page you need to add the placeholders, like in the image below (placeholders should be added surrounded by double curly braces - {{placeholder_name}}). homepage placeholder Then, you can simply add a matching registration field on your checkout form to capture that data: checkout form Your customer will then be able to fill that field during the registration. registration field WP Ultimo will then replace the placeholders with the data provided by the customer automatically. replace placeholder Solving the "template full of placeholders" problem All of that is great, but we do run into an ugly problem: now our site templates - that can be visited by our customers - are full of ugly placeholders that don't tell much. To solve that, we offer the option of setting fake values for the placeholders, and we use those values to search and replace their contents on the template sites while your customers are visiting. You can have access to the template placeholders editor by heading to WP Ultimo> Settings > Sites, and then, on the sidebar, clicking the Edit Placeholders link. placeholder settings That will take you to the placeholders' content editor, where you can add placeholders and their respective content. template placeholders

Last updated on Oct 16, 2023

Tax Handling

WP Ultimo has a tax collection module built into our core plugin, so if you need to collect sales taxes on your plans, packages and services, you can easily do so without resorting to installing any add-ons. For companies located in Europe, we offer an add-on that adds tools and features to better support VAT compliance. WP Ultimo does not file or remit taxes on your behalf to the government; we simply help you collect the appropriate taxes at the time of the transaction. You’ll still need to remit taxes on your own. Enabling Tax Collection Tax collection is not enabled by default. To enable it, you need to go to WP Ultimo > Settings > Taxes and toggle to enable the Enable Taxes setting. Tax excluded vs. Tax included By default, all your product prices are tax excluded, meaning that taxes are not included in the product's price. If we determine that a customer should pay taxes on a given purchase, we'll add the taxes on top of the subtotal. If you prefer to have taxes included in your product's price, you can do so by enabling the Inclusive Tax setting. Don't forget to save the changes you've made. Creating Tax Rates After you enable Tax Collection, you'll need to create tax rates for specific locations using our tax rates editor. You can access the editor by clicking the Manage Tax Rates button on the sidebar of the Tax settings page. On the tax rates editor page, you can add new Tax Rates by clicking the Add new Row button. You'll need to give each tax rate a title (used on invoices). Then you can choose the country (required), the state, and the city (both optional) where this tax will be charged. Finally, add the tax rate in percents. Tax Categories You can also create multiple Tax Categories, to add different tax rates for different kinds of products. Click to Add new Tax Category, then write your category's name and press Create. To browse through categories, click Switch and select the category to which you want to add new taxes. You can set the tax category for a particular product by going to the Product edit page and then to the Taxes tab. On that same screen, you can toggle off the Is Taxable? toggle to let WP Ultimo know that it should not collect taxes on that given product. European VAT Support As mentioned before, we have an add-on available for customer in the EU that have additional requirements due to European VAT regulations. Our VAT tools help with a couple of important things: - Easy loading of EU VAT rates; - VAT Number collection and validation - and reverse charging for VAT exempt entities (such as companies with valid VAT numbers); To install that add-on, go to WP Ultimo > Settings and then click on the Check our Add-ons sidebar link. You'll be redirected to our add-ons page. There, you can search for the WP Ultimo VAT add-on and install it. Then, head to Network Admin > Plugins and activate that add-on network-wide. If you head back to the Tax Settings tab, you'll see new options available. Toggle the Enable VAT Support option to enable the new VAT tools. Don't forget to save your settings! Pulling on VAT Tax Rates One of the tools that our integration adds is the ability to load the tax rates for EU member states. That can be done by visiting the tax rates editor page after enabling EU VAT support. At the bottom of the page, you'll see the VAT pulling options. Selecting a rate type and clicking the Update EU VAT Rates button will pull up and auto-populate the table with the tax rates for each EU member state. Then, you only need to save it. You can also edit the values after pulling them. To do it, simply edit the table line you need and click to save the new values. VAT Validation When VAT support is enabled, WP Ultimo will add an additional field to the checkout form, bellow the billing address field. The field will only show up for customers located in the EU. WP Ultimo will then validate the VAT Number and if it comes back as a valid one, the reverse charge mechanism is applied and the tax rate is set to 0% on that order.

Last updated on Oct 16, 2023

Auto Search and Replace in Site Templates (v2)

This tutorial requires WP UItimo version 2.x. One of the most powerful features of WP Ultimo is the ability to add arbitrary text, color, and select fields to the registration form. Once we have that data captured, we can use it to pre-populate the content in certain parts of the site template selected. Then, when the new site is published, WP Ultimo will replace the placeholders with the actual information entered during registration. For example, you can do your template sites with placeholders. Placeholders should be added surrounded by double curly braces - {{placeholder_name}}. Then, you can simply add a matching registration field to capture that data Your customer will then be able to fill that field during the registration. WP Ultimo will then replace the placeholders with the data provided by the customer automatically. Solving the "template full of placeholders" problem All of that is great, but we do run into an ugly problem: now our site templates - that can be visited by our customers - are full of ugly placeholders that don't tell much. To solve that, we offer the option of setting fake values for the placeholders, and we use those values to search and replace their contents on the template sites while your customers are visiting. You can have access to the template placeholders editor by heading to WP Ultimo > Settings > Sites, and then, on the sidebar, clicking the Edit Placeholders link. That will take you to the placeholders' content editor, where you can add placeholders and their respective content.

Last updated on Oct 16, 2023