Jump to content


Marc Stridgen

Invision Community Team
  • Content Count

  • Joined

  • Last visited

About Marc Stridgen

  • Rank

Profile Information

  • Gender

Recent Profile Visitors

The recent visitors block is disabled and is not being shown to other users.

  1. I have taken a look at this for you, just to ensure things are correct in there. While we can certainly look to make this clearer in our documentation, it does indeed currently state what the URL should be, in the following section. As the full URL can be different per site, it is not possible to add the full URL in there, unfortunately. Just as a quick hint for you on these. Whenever setting up items like this, you will tend to find the callback URL is shown within the setup page of that particular item. So for example, when setting up the twitter login method, you will see under the "Application Settings" section, it will let you know what URL you should use for the callback URL. Of course, if you have any feedback to add to this, do feel free to pass that on. Any way in which we can make things more straight forward for our users, we are always happy to hear ☺️
  2. Stripe support on your product can be set up quite easily, for your customers to purchase items within commerce. This can be used either for one-off payments or for recurring payments via card. Stripe supports various items such as card payments, apple/android pay, alipay and more. You would set up any payment method, including the Stripe payment method, from the following location in your AdminCP Commerce > Payments > Settings > Payment Methods Stripe API Key We recommend when setting up stripe, you have 2 tabs open in your browser, so that you can copy and paste the relevant details from your Stripe setup, directly to the payment method setup screen within your admin CP. First of all, go to the payment methods section in your Admin CP, and select "Create New". Selecting the Stripe method, as shown in the image below, then click Save. In another browser tab, log into the API section of your stripe account . If you havent created an account already, you will need to create yourself a stripe account using the register button. On first login, you may see the following screen. If so, click on "Use the Stripe API" If you have just set up your account, you will need to activate this before you can create an API key. Select the "Activate your account" link shown below. Here you will be asked to enter details about what you intend to use the stripe payment method for, along with bank and other details relevant for your payments to be received. Once activated successfully, click to get your API keys, using the link provided. Click to show the Secret Key, as shown in the image below. You now have the 2 API keys you need to copy into your payment method in the admin CP (Leave the tab for stripe open. You will need this again) Copy these 2 keys into the area provided in the ACP, enter a name for your payment method, and select any restrictions to countries, if required. Payment types In the next section of your payment method, you will see the methods that can be chosen for payment on stripe. Select the method you wish to use here for this setup. It is important to note, you can set up this stripe payment method more than once if you wish to use more than one of these items. For example, you may wish to provide your users with the facility to pay with apple/android pay, and also set up the facility to use cards. You can choose here also whether or not you wish to use the 3D secure option provided by card issuers if available, and whether or not to store the card details. If you do not choose to store card details, then the card method would only be able to be used for one of payments, and not automated billing of items such as subscriptions. Stripe Webhook In order for Stripe to be able to tell the system when a user has paid, a webhook must also be set up. Back on your Stripe API page, select the "Webhooks" option from the menu Select to create a new Endpoint for the webhook, in the top right of the page Go back to your adminCP tab, and copy the endpoint URL, which is provided for you at the bottom of the payment method setup page Copy this into the box provided, and then select "receive all events". Once you have done this, select "Add Endpoint" Once this has been added click to reveal the Signing Secret, and enter this within your payment method, into the box provided. You can now click save on the payment method in your admin CP, and this will be available for use within commerce purchases.
  3. PayPal support on your product can be set up quite easily, for your customers to purchase items within commerce. This can be used either for one-off payments or for billing agreements that allow for recurring payments such as for a monthly subscription. You would set up any payment method, including the PayPal payment method, from the following location in your AdminCP Commerce > Payments > Settings > Payment Methods PayPal Application Before we can set up the PayPal payment method within the AdminCP, we must first create a PayPal REST API App within the paypal developer page. Once on the page, log into the dashboard using the button in the top right. This will be the details for the paypal account you will have people paying in to. If you do not already have a paypal account for this, you would need to create one first of all. Log In If you have used this area before, you may see other items as we see in the screnshot below. Don't worry however if you have not. In either case, you need to click "Create App" to start creating a new REST API Application. Create an Application First os all enter an application name. This is simply a name to identify this in your developer dashboard, so it can be anything you like here. You will also note it asks for a sandbox business account. This can be left as it is on its default setting. Click on "Create App" to create your new application. Application Name Once we have done this, it is important that you select the "Live" tab, as this will have the details you need to enter into your Invision Community AdminCP Ensure you select 'Live' Once on the live page, click on "Show" in order to show the 'Secret' key, which you will need for your Invision Community AdminCP. Show the 'Secret' key Now that your application is created, you need to copy the Client ID, and Secret shown below. These will be used in the next stages to set up within commerce. Copy the Details Required Creating the Payment Method Now that we have the application set up in PayPal, and have the Client ID and Secret, its time to set this up within your AdminCP. Go to the following location and select to create a new payment method Commerce > Payments > Settings > Payment Methods Select the PayPal method, and then click next Create a New PayPal Method You can choose any name you wish for your payment method, including a name for each language pack you have on your system. This is the name that will be shown to the user on the front end, and would usually simply be named PayPal. You can however choose anything you like if needed. Your Client ID and Secret are then added to the locations provided. Enter Your App Details You will note also on this screen you can restrict the payment method to be available only to certain countries, should you wish to do so. The billing agreements section here. You can switch these off entirely, have them as optional, or set them as required. This enables a billing agreement (previously known as recurring payments) to be set up between yourself and the customer, for items such as subscriptions. If a billing agreement is set up, then after the first payment, any renewals would be automatically requested from the customers paypal account. Billing Agreement Selection It is important to note, that if you disable Billing Agreements on this page, you can still use subscriptions if you wish to do so. What would happen in this scenario, is that the invoice would be created, and would be available for your customer to manually go ahead an pay. Failure to pay this after the given period would then result in the invoice expiring. Once you have added all the details needed, simply select "Save" which will then make the method available for use.
  4. There are various other settings for member profiles within the suite, which can be set up by the administrator, to better suite the needs of any particular site. These settings can be found within the following location of the ACP. Members -> Member Settings -> Profiles -> Profile Settings Profile settings From this location, you can switch on/off various items, and set defaults relating to peoples profiles upon registration. Profile Settings Page The following items can be set from this location Photo settings - In this section, you can various options related to profile photos, their defaults, and what you would like to allow the user do do in relation to being able to add them Display Names - This is where you would set what is allowable as a display name on sign up. You can set the length requirements, along with what chars you wish for the users to be able to use. For example, you may wish to restrict to only the latin alphabet, along with numberic balis, hyphens and underscores. For this you would enter 'a-z0-9-_' If you wish to stop people using a specific name or term within their display name, you can restrict this from the ban settings page, discussed in the following guide Signatures - These are a signature that would be placed under your members items of content, when posting in the forum areas. You can choose whether or not to use these on your site. Status Updates - Here you can set whether or not status updates can be used by your members. These are small statuses, that you members can use within their profile. Birthdays - While a date of birth is entered on registration, you can choose whether you wish for people to be able to see them on the users profile or not, by default. Settings so this is visible in profiles, will allow it not only in profiles, but also within the calendar and birthday widgets, if set up. Ignoring - By default the system allows users to ignore other members. This can be ignoring the user altogether, or simply ignoring something like a signature. You can disallow this from the profile settings page here. Note, however, that if you wish to just stop certain members from being ignored, you can do this from the group settings. Display Settings - Group formatting which is set within each group, will be shown only on the group name by default. For example, if you have an 'Administrators' group, which is colored red, then the word 'Administrators' will be colored. If however, you switch to 'Global' then the username itself will be colored, in all areas where the group name is not shown.
  5. Your tickets there have been responded to. Note that only urgent requests would generally be responded to during the weekend period. This should be resolved at some point today for you.
  6. When creating new database template, there will be times where you want to add custom fields in specific locations with them. This guide covers how custom fields are used within your own custom database templates, examples on how to enter these, and a brief explaination of each field display type. The Basics In order to understand how custom fields are used within templates, it is important to understand the items in which will be used within your template code. When creating a custom field with a view to displaying in your own templates, the following items will be of note when you are creating these Display Methods Template Key - This is how you will reference your field within your template. When creating fields, try to stick to a convention of naming which is relevant to what the field contains, and the database if you have more than one. So for example I may have 'bugs_area_text' which would be clear to me in my instance, that it's the bugs database, the field which shows the area where the bug is, and it's a text field. Sticking to some sort of convention may help make your templates easier to read as you are developing them. Listing View Format - This is the format used when referencing the listing view, which will be discussed below. Display View Format - This is the format used when referencing the display view, which will be discussed below. Note also that display is the default view to be used if no other is specified. Display - In addition to the Display View Format, there is also a specifier for where this should be placed. You can reference each of these options specifically in your template code. Template Syntax Any field you have created can be used within your database templates. This can be done using the following code {$record->customFieldDisplayByKey('your_template_key', 'viewtype')|raw} The template key parameter would be whatever you have entered in the 'Template Key' field, in the display tab of your custom field. The view type parameter is what you would use in order to specify what format you are using, which would depend on which of the options from your display tab in your custom field you wish to show. The view types that can be used are as follows listing - This will show the value as per any listing badge preferences as set up on your custom field. This is usually used within a record list. display/display_top/display_bottom - Each of these show the value as per any display value set up in your custom field. Display on its own will just show the format, however you can use display top and bottom to display based on which of these items is selected within that field for the display section. thumbs - returns an array of \IPS\File objects . Returned only with image types, where thumbnail creation is selected. upload- returns an array of \IPS\File objects . Returned only with upload field type. raw - this will show the value as store in the database, unless there are muliple upload (returned as an array of URLs) or they are a Reciprocal field type (returned as an array of record objects) processed - this will show the raw value as specified above, however is also passed through the form helper Adding |raw will mean that the value will not be escaped. For some items which specifically contain URLs this may be desirable. For example returning a thumbnail, or a youtube item. However if using for items such as plain text, please be aware that you are allowing raw unescaped text to be added to the page. An Example For this example, I have created a field named "Sub Title". First of all I have set my field up. For this item I am aiming to add a subtitle to the record, shown below. Template Key I'm happy with one of the preset display options, do have selected the one below Display View I now need to edit my record template, and add in the line where I require it to show up. In this case, just below the title Template Edit Note that the syntax used here includes the |raw at the end. This is because what will be returned will the the HTML from the standard display format I have chosen, and I dont wish for this to be escaped. {$record->customFieldDisplayByKey('sub_title', 'display')|raw} Result
  7. No. In this case its these ones here
  8. There is nothing for you to figure out there. It's a performance improvement which means the letters for profile photos load more quickly.
  9. Invision Community allows the ability for guests to create a response to a content item they wish to engage with, without barriers of first creating an account, by allowing the user to post and then register afterwards. This will be incredibly valuable when you consider how much traffic a forum receives from inbound Google searches. With Post Before Registering, you'll increase your chances of turning that inbound lead into a registered member contributing to your site. Switching on You can switch on posting before registration in the following location within your admin CP. System -> Settings -> Posting -> General Switch on guest posting Posting as a guest When a potential member posts a new content item, or responds to an existing content item, they will be asked nothing more than their email address when posting, as seen below New topic as guest Once they have posted, they are asked to simply complete their registration. They are more likely to do this now they have invested in your community. Asked to register Therefore guests will see the ability to submit content, but then will immediately be prompted to register an account before the content is actually submitted and viewable. This is useful for encouraging guests to register. Guest users will have up to one week to complete their registration before their content will be permanently removed. If the guest user does not complete their registration immediately, they will be sent a reminder email shortly after making the post.
  10. The invision community system sets up emails via the email template system. This gives you the ability to amend the email structures from within your ACP, without the need to edit any core files. The following guide shows how the Email Template system works, and where you would be looking in order to change a particular email. Email Structure The email template structure is made up of 4 parts, in which you would need to be aware of to make changes to your emails. Email Wrapper Template - The email wrapper is the surrounding template for all emails. Each email type will be 'wrapped' by the email wrapper when building up the email, and so is where the basis for the look of your emails would be changed. Note there are some examples of templates which do not use the wrapper. These are specified in the template name, as shown in the example below. The wrapper can be previewed at any time. using the button provided at the top of the template list. Content Templates - All other templates are the body of specific emails, and would be the contents that sit within the email wrapper. For example, you may see an item such as 'Staff Reply', which is the email template for when staff respond to a ticket. This is the template for the content of that email, which would then be pushed into the Email Wrapper. Tags - These are items which are specific to an email type. You will see an available list of these in the side of the editor for each template. For example, the email wrapper has tags for subject, member, content, unsubscribe and more, which can be placed within the template. Language Strings - It is important to note that most text within an email which is not dynamic, will come from a language string. In most cases if you are editing simply the wording of an email, you will find these within the language editor Templates Templates for emails work in a similar manner to that of theme templates. Any tags available will be shown on the left, and can be clicked to add to the email template itself. Additionally, below is a highlighted example of where you would look at a language string to change content. In this case, the language string email_registration_validate is used, so you would visit that language string to change its contents.
  11. What is EasyPost? Enabling integration with EasyPost provides direct API access to shipping and logistics, when a user purchases a physical item. This allows for items to be priced based on the current price to ship an item, direct from the supplier of that service. Creating a EasyPost Key In order to create a EasyPost API key, you will first need to create an EasyPost account on their website. Once logged in, click the API link shown in the left bar, as shown in the following image, by selecting your name, then API Keys. You need to copy the Production API key from this location. API Key Location Adding EasyPost to your site Now you have your API key, you can add EasyPost to your Invision Community site. To do this, visit the following area within your admin CP System -> Site Features -> Community Enhancements Once here, select the "Enable" button under EasyPost. You will then be shown the following where you need to enter the key you have just created and select 'Enable'. For EasyPost, you must have an address set up to set from, which can also be set either in this location, or it can use your settings from General Configuration if needed. API Setup Once you have set up your required settings, you can test the EasyPost API if you would like to do so. To do this, select the "Test Settings and View Rates" button in the top right of that screen. This will present you with the following Testing EasyPost Add a product, a member, and a destination address. You will then be shown the rates available for that chosen location.
  12. What is Giphy Integration? Giphy integration will allow your users to click and select GIF images, directly from the editor. This will pull and search gifs on the popular Giphy platform, allowing for ease of use, and expression through short media videos The Invision Community platform allows you to set up giphy integration, by simply adding your giphy API key into the platform, requiring no coding knowledge to add. Getting your Giphy key If you are using Invision Community 4.4.4 or later, then you do not need to apply for your own key. Yes! No need for requesting your own key! Invision Community 4.4.3 and older: In order to integrate giphy into your site, you must first create an accoun on the Giphy site. Once logged in, you can create a pixel by selecting "Create an App" button at the top, as shown in the image below Create an app At this point you will be asked to give your app a name and a short description, as shown below. App details You can now copy your API key, which will be used in the next step to add to your site. Important: You must continue through all steps in the guide, as once you have tested, y ou need to get your application into production. API Key Adding Giphy to your site Now you have your API Key, you can add giphy to your Invision Community site. To do this, visit the following area within your admin CP System -> Site Features -> Community Enhancements Select "Enable" under the giphy option, which will then allow you to enter your key, and optionally select the ratings of GIFs you wish your users to see API Key Entry Putting it in production In order to continue using GIPHY, you must select "Request a production key" which you can see under your key on your GIPHY dashboard. Fill in the details as appropriate on the application form Giphy Production Key Application Once you reach the point where you are asked for images, you can use the provided images, or create your own similar images, and place them in the locations shown below Images to be added Sample Image 1 Sample Image 2
  13. What is Mapbox used for? Enabling integration with Mapbox provides autocomplete functionality when a user enters an address (which is particularly useful if you are using the Commerce application) and can display maps when looking at IP addresses and elsewhere. This is an alternative to the preferred googlemaps enhancement, where google maps may not be an option. Creating a Mapbox Key In order to create a Mapbox API key, you will first need to create a Mapbox account on their website. Once logged in, you will see you are automatically given a public token (this is your API Key) for use on your site. Copy this token which will be used in the next step Get your key Adding Mapbox to your site Now you have your API key, you can add mapbox to your Invision Community site. To do this, visit the following area within your admin CP System -> Site Features -> Community Enhancements Once here, select the "Enable" button under Mapbox. You will then be shown the following where you need to enter the key you have just created and select 'Enable'. Enter your API key in the ACP Once done, this will enable the integration in various areas of your site where locations and addresses are shown. For example the location shown here in the admin CP on a members profile Map example
  14. What is Facebook pixel? The Facebook pixel is an analytics tool that allows you to measure the effectiveness of your advertising by understanding the actions people take on your website. You can use pixel data to: Make sure your ads are being shown to the right people Build advertising audiences Unlock additional Facebook advertising tools The Invision Community platform allows you to set up facebook pixel, by simply adding your pixel ID into the platform. Pixel Stats Getting your Pixel ID In order to integrate your facebook pixel, you must first create one on the facebook business site. Once logged in, you can create a pixel by selecting "Get Started" as shown in the image below Getting Started You will then be asked to create a name for your Pixel, along with giving your sites URL Add your name and URL here As you are using the Invision Community platform, the next step in creation is not needed. We have added the integration to the software already, so you need only your pixel ID in order to continue here. Therefore we will simply close this screen. Integration is already done You will now see that you have a pixel ID in the top left of your screen, you will need to copy this, as this is what you will need to get started on setting up in the Invision Community platform. Copy your pixel ID Adding Pixel to your site Now you have your Pixel ID, you can add facebook pixel to your Invision Community site. To do this, visit the following area within your admin CP System -> Site Features -> Community Enhancements Once here, select the "Enable" button under Facebook Pixel. You will then be shown the following where you need to enter your pixel ID and select 'Enable. You can also set a delay if needed, which can avoid re-targeting bouncing users, by adding a delay before the pixel loads. Integrating your pixel
  15. Often there will be resources you wish to use within pages, pages templates, or theme templates, such as images, fonts and more. While you could upload these via ftp to somewhere on your server, or another server, with the pages application Invision Community 4 provides a way in which you can upload these directly from your admin CP. Media Manager The Media Manager can be found in the following location within your ACP Pages->Page Management->Media Page Management->Media From here you can upload new items using the button provided. This can be files of any type that you wish to use within your templates or pages. In addition, you will notice in the top left you can create folders for these, in order to categories as needed. Using Media Tags Once you have your media uploaded, if you click on any of your resources you will see the info panel open on the left. This shows the media tag for that resource, which can be used to point to that resource in any location of your templates or pages. Info Panel You can use these in any way that you need. For example here I have added an image to the top of the Category Index within the default database templates as follows <img src="{media="1"}" /> Example
  • Create New...