[Redirect]https://help.themehouse.com/docs/covers/getting-started-with-covers[/Redirect]

Thank you for your interest in Covers! Here you will find documentation for Installing Covers, Options, Cover Presets, Permissions, Cover Browser, and Tools. If you need something specifically explained, please feel free to get in touch. Give your users the ability to customize their experience by setting cover images at various locations throughout your forum. Create a personal experience for your users to keep them engaged while still having control.

Install & Upgrade (Recommended) To install using Install & Upgrade, please refer to the Install & Upgrade documentation. Manual Installation Download the add-on from your customer area. You will be asked to provide some information before downloading. Once you download, save the .zip file somewhere you are familiar with. Next, extract the files. You will need to upload the contents inside the upload folder into your root XenForo directory. You may be prompted to overwrite files when uploading, go ahead and confirm. After you have uploaded the files you will need to navigate to the Add-ons section within your XenForo admin panel. Here you will see it listed under "Installable add-ons". Just click Install! Congratulations! You have officially installed the Covers add-on on your site. ZIP Upload (XenForo 2.1. and higher) Your first step is to download the add-on from your customer area. You will be asked to provide some information before downloading. Once you download, save the .zip file somewhere you are familiar with. After you have downloaded the file, you will need to navigate to the Add-ons section within your XenForo admin panel. Click “Install/upgrade from archive” and follow the on screen instructions. When asked for an add-on archive, select the previously downloaded file. Congratulations! You have officially installed the Covers add-on on your site. If you need assistance getting the add-on installed or would prefer us to handle it for you, you can create a ticket.

To navigate to Options, go to ACP -> Content -> [TH] Covers -> Options. These options allow you to enable/disable items which will show on the user’s profile with the cover itself applied. Such items include: User Title The custom user title or user title set by you or a user group. Last Seen Where you were last seen on the forum or how long ago it has been since you were online. User Banner The user banner which is set by you when creating a user group or user group banner. Use covers as Open Graph images This option allows cover images to be embedded as Open Graph meta information for display on social media. The following options below allow you to show the profile cover on the selected positions shown below. Such positions include: Member card Visitor menu Maximum cover file size This option allows you to set a maximum attachment file size in kilobytes (KB). When users attempt to upload attachments that are over the size specified, they will be rejected. Allow content owners to create/edit covers This option when enabled allows content owners to create or modify covers if they have the appropriate permissions.

Cover Presets To see, add, or edit cover presets, navigate to Content -> [TH] Covers -> Cover presets within the XenForo admin control panel (ACP). To create a cover preset category, click on the + Add category button. You can then enter a Title and Display order. The categories will be displayed on the cover preset selector. To create a cover preset, click on the + Add preset button and enter the necessary information. General Title The title of the cover preset will be shown on the preset listing, cover list, and on the users preset listing when they set it on the front-end of your forum. Display order This allows you to organize the most popular covers in the list itself. The lowest number will be at the top while the highest number will be at the bottom. Enabled This allows you to enable the cover preset, unchecking it will not disable that preset on any existing cover. It will still be available for selection on profiles, resources, and threads unless changed by an administrator of your board. Default The content types are listed below. Selecting the cover as a default will remove the old default from the selected content types below. For those who have chosen their own custom image and/or background color this will have no effect. If you decide not to check any of these content types, but enable them, users will be able to use them anywhere (permissions, user criteria, or user field criteria permitting). Resource Thread User Styling Cover image URL Enter the URL for an image. Background color Choose a color to have a background color. Criteria The User criteria, User field criteria, and Remote platform criteria tabs allow you to specify which users are able to use the preset created. The Remote platform criteria comes from the platforms you have set up using XLink. If you don’t have XLink or any platforms set up, this will not be an option.

User Permissions The following user permissions can be set: User profiles permissions View profile covers Edit own profile cover Upload image for own profile cover Download image for own profile cover Position own profile cover image Style own profile cover image Use presets for own profile cover Delete own profile cover Thread permissions View thread covers Edit own thread covers Upload image for own thread covers Download image for own thread covers Position own thread cover images Style own thread cover images Use presets for own thread covers Delete own thread covers Resource permissions View resource covers Edit own resource covers Upload image for own resource covers Download image for own resource covers Position own resource cover images Style own resource cover images Use presets for own resource covers Delete own resource covers Moderator Permission The following moderator permissions can be set: Edit all covers Approve / unapprove all covers Administrator Permission The “Manage [TH] Covers” administrator permission can be set.

To navigate to the Cover browser, go to ACP -> Content -> [TH] Covers -> Cover list. The cover browser allows you to view all covers that have been assigned to content. You are able to search these covers by content type, username, range of date between in which they were last modified, and more. If you would like to remove a cover, you are able to select any of the covers listed and delete it. You are able to view covers on user profiles, threads, or resources by clicking the ‘View host content’ link. Edit Cover When viewing the edit cover menu, you will notice a few buttons and information about the cover as well. [Modify image] Upload a custom cover through your computer or download it through a URL. [Style cover] Set a custom background color behind the cover image. [Position cover] Adjust the position of the cover by moving the image. [Choose cover preset] Clicking this button shows what cover presets are available before allowing you to select a cover preset that you’ve created on the back-end. After it is selected, it will update the user's cover. [Delete] Clicking this button will delete the user's cover, please only click this when necessary as there is no way to revert this. Content Type This shows what content type this cover is. For example: [User] Name, [Resource] Name, and [Thread] Name. User This shows the user who is using the cover itself. Edit date This shows when the cover was last edited, rather it be recoloring, replacing the cover image, or the preset itself. Preset This shows what preset is being used. Background color This setting allows you to display a background color of your choosing.

Import data You can import from ThemeHouse Covers for XF1 by navigating to ACP -> Tools -> Data maintenance -> Import data -> find Import target: [TH] Covers then follow the prompts.