Jump to content

Community

Marc Stridgen

IPS Staff
  • Content Count

    181
  • Joined

  • Last visited

About Marc Stridgen

  • Rank
    Member

Profile Information

  • Gender
    Male

Recent Profile Visitors

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

  1. 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
  2. No. In this case its these ones here
  3. There is nothing for you to figure out there. It's a performance improvement which means the letters for profile photos load more quickly.
  4. Invision Community allows the ability for guests to create a post to a topic they want 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 topic, or responds to a topic, 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.
  5. 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.
  6. 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.
  7. 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 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
  8. 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
  9. 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
  10. 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
  11. There are various reasons that you may wish to create a robots.txt file. This may be because you wish to block the indexing of certain pages by search engines, or even block a search engine altogether, amongst many other reasons. But did you know you can do this with the pages application? Creating a robots.txt file with the pages application can be helpful if you have no access to your server via ftp, such as on the cloud platform, and also gives you a quick location for you to edit these without the need to ever access the file directly. Creating the page In order to create you robots.txt file for the site, you need to create a new page within the following location in your ACP Pages -> Page Management -> Pages When creating a new page, choose the 'Manual HTML' option, which will allow you to manually create pages in code. When creating use 'robots.txt' as the page and file name Robots.txt example It is important to note in the above that we have deselected the "Use suite HTML wrapper" option. This is done so that we are directly creating just text on the page for search engine use, rather than surrounding with the wrapper from the rest of the site. Also, ensure this is not placed within another folder, and is instead at the root of your pages application. Adding content Adding content to your robots.txt file is then as simple as adding whatever you need to the contents tab. Here I have added a simple entry to tell googlebot not to index my site. robots.txt entry When saving, you must ensure you give permissions for guests to view that page, otherwise search engine bots will not be able to view the contents/rules you have in place. Upon saving you will see that the robots.txt file is available from yourSiteURLHere/index.php
  12. With the advent of social media such as the likes of facebook and twitter, this can provide great opportunity to promote your site to new potential members. Worldwide, facebook currently have close to 1.9 billion users active every month. Users talking to each other, and sharing interests at an unprecedented speed. Within the Invision Community application, we provide the tools you need to take advantage of the marketing opportunities that this can provide for you and your site, by the use of social promotion of content, straight to your facebook page, group, or twitter feeds. Setting up Social Media Promotion can be set up from the following location within your Admin CP System -> Site Promotion -> Social Media Promotion You can choose to set up multiple areas to promote to within this section, both internally and externally on social media. These include Facebook Pages Facebook Groups Twitter Feeds Our picks (internal promotion) Facebook Setup The first tab you will see within the setup pages is for setting up facebook. In order to use facebook promotion, you must first set up a facebook application, and allow the relevant permissions on that facebook application to promote content. You can do this by following the instructions in the following guide https://invisioncommunity.com/4guides/how-to-use-ips-community-suite/social-sign-in/43-and-above/facebook-r300/ Already have facebook login set up? In order to add permissions to a facebook application for the promoting of items, you have to have your application in developer mode. If you are happy to do this, then you can switch your facebook application to developer mode, and add the permissions as described in the facebook guide. However, this will prevent anyone from using facebook login while you set these up. In this scenario, you have 2 options. Option 1 would be to set up a test application. Within your facebook developer area, select your application, then select the dropdown in the top right. Here you can select 'Create Test App'. WARNING:- If you use this option, then only yourself will be able to promote, unless you add other facebook users who are connected to your site, as administrators for that facebook application, in the 'Roles' Section Option 2 would be to set up a completely new application, which you would do in the same manner of as you did originally. In either of these 2 scenarios, you would choose to use a different Facebook application for social promotion After setting up facebook promotion, you can then choose to promote to one or more groups or pages on facebook, by ticking the relevant boxes. Here we have chosen to submit to the 'Dragons' group. Choosing Pages/Groups If you wish to do so, you can also automatically add one or more hashtags to your promoted items Hashtags will automatically be added to promotions Twitter Setup As with the facebook item, selecting the 'Twitter Promotion' tab will first of all prompt you to set up a twitter login, if you havent already. Please see the following guide for information on how to set up a twitter application. https://invisioncommunity.com/4guides/how-to-use-ips-community-suite/social-sign-in/43-and-above/twitter-r303/ When promoting to twitter, you can set up as many hashtags to be sent alongside your promoted content as you wish. Due to the limitation on text you can use on a tweet, you can select what to do in the scenario that your limit is used. Twitter promotion setup Link Shortening To reduce space on your promotions, you can optionally make use of the external provider bitly, to shorten your links. In order to do this, you would need to set up a bitly account, and enter the access token for this. bitly setup Setting up this would give you shortened URLs on promotion. For example https://bit.ly/2IizDkN , which is a shortened link for our own site here. Scheduling When you are promoting content, you may not necessarily want content to be sent straight away, but instead always sent on schedules of your choosing. For example, many will send at times such as 13:10 as people will have just gone on lunch (so will be checking their social media). You can set up automatic schedule times from the Auto Schedule tab, which can then be used when promoting content. Scheduling Promotions Permissions Permissions for promoting content can be set up on a group by group basis, by checking the selection box within the groups you wish to allow to promote. You can read more about editing group settings within our group settings guide. However there will be times where you wish to add an individual to be able to promote. This can be done from the permissions tab within the promotion section, by adding the name of the person(s). Individuals able to promote Our Picks On the final tab, you can switch on the 'Our Pick' option. This is an internal promotion, that will promote to the 'Our Picks' page, as seen below. Our Picks Additionally, there is a block in which will show these, which you can select from the block manager, and place anywhere you wish on your site. Using Social Promotion Promoting an item Each item such as topic, gallery album, blog entry etc, has its own Promote button. You can see this in the top left of the page. Selecting this would allow you to promote to any of the items you have set up for social promotion, such as facebook, twitter, or my picks. Click to promote In addition to promoting content items, you may also wish to promote an individual comment or post. This can be done by selecting the 'Promote' button within the options menu Promoting an individual comment Once one of these buttons has been selected, you will be shown the promote page, where you will be given a preview of what is to be shared. Sharer Page From here you can customise the text that you are sharing if you wish to do so, along with upload new images for sharing with this. The system is smart enough to add images from the post automatically, so these can also be selected for use. Once you are done, you can either promote the item using the promote button, or can change the schedule for when this will be promoted. The auto schedule will use the times set up within your AdminCP in the Social Media Promotions setting. Scheduling Once promoted, you will then see this in the platforms you have chosen, as per below example. Promoted to Facebook Managing Promoted Content The status of promoted content can be seen by selecting your name in the top right, and selecting "Manage Promoted Items". From here you can see an icon showing where items have already been promoted, along with delete the items from the queue if needed (also deleting from the 'My Picks' page) Managing Promoted Items
  13. With a bit of effort, I recon I could spend it in a week. 😄
  14. Increasing the security of your site, over the usual login layer, can be an important factor for many users. Whether this be for everyone, or just for the extra security of admin areas on your site. Two factor Authentication allows you to add an extra layer of security to your site, by allowing you to add another form of login, such as security questions, or even text message authentication. Overview All two factor authentication settings can be found within the following location in your ACP System -> Settings -> Two Factor Authentication There are 3 different methods of 2 factor authentication, each of which are discussed below. When one of these is set up by the user, it will prompt the user for one of these secondary items after they have logged in. 2 Factor on login The user can set up these items from their security settings in Account Settings -> Security settings. Here you can see I already have security questions set up. I can amend these using the option provided, or activate another if one is available. Account Settings Area When setting up these, the system will ask you any details required for you to set up that option. Here the system is asking us for 3 security questions. Question Setup Authentication Types In the default setup of the platform, there are 3 authentication types which you can allow (or even force) people to use on your site. These can all be seen within the following location of your ACP, and can be enabled by selecting the icon at the side of the relevant icon System -> Settings -> Two Factor Authentication Click to Enable/Disable Authy The Authy method of authentication will allow users to authenticate via text message, phonecall, or by the Authy app which can be downloaded to the users phone. In order to set up authy, you would need to get an API key from the authy site https://dashboard.authy.com/signin Once you have this, add the API key in the location provided, and set up which options you wish to use for this. Authy Settings Google Authenticator Google authenticator will allow people to authenticate on the site using the google authenticator application on mobile (downloadable from the app store/play store). The only settings for this are which groups that can use it. Other than this, it simply needs switching on. No other configuration is needed. When the user initially sets this up, they will be given a barcode to scan with the authenticate application. This will in turn, give a code to be entered into the site. Each time the user then enters the site, they will be asked for the code on their application, which will change every few seconds and is unique to that individual account Google Authentication Setup Security Questions Setting up security questions for use will allow the user to answer any of the questions you have set up in their settings, and then be prompted to provide that same answer to a random one of those questions on login. On the settings page, you can set whether or not you wish for this to be mandatory, along with how many questions you want them to set up. You will find on the questions tab, there are some pre-populated questions which are set up within the stock installation for your use. You can delete, edit, or add to these questions from this page Question Creation Settings On the main settings page for Two Factor Authentication, you will find many different options relating to how this will work on your site. This includes the ability to set up groups in which setting up 2 factor authentication is mandatory, which can often be an important security consideration where groups have more access. For example, you may wish for the administrators group to have to set up 2 factor authentication. In addition, here you can set up what prompts 2 factor authentication. So it may be that you want people to use this when logging into the ACP and changing passwords only, for example.
  15. Creating a homepage for your site has many benefits including: Showing your best content first By using the "Our Picks" blocks, you can display your best content first. This content sets the tone for the site and will encourage engagement across your site. Display multiple areas of the suite Each application has its own feed blocks that can be used to display content on the home page. If your members use Gallery heavily, then showcase those photos on the homepage. If you use Calendar a lot to schedule events, then show event feeds. By displaying feeds to content is a great way to showcase all areas of your site on a single page. Reduce confusion For those of us that grew up with forums are used to viewing a list of categories and forums. We find it easy to scan the list of forums and dip into the ones that interest us. For those that are not so familiar, a homepage displaying easily accessible content reduces the confusion and invites true content discovery. Basic Homepage While the pages application can be as complex as you would like to make it, creation of a basic homepage can be quite simple to do, even if you are a beginner in using the platform. The following video shows how to create a basic application using the block manager Whilst creating your home page, and re-organising you site, you may also find the following guides helpful in obtaining more information about some of the items discussed in this video. Databases There may be times where you wish to add your own database driven content to your homepage. For example you may want to add some articles in there, which are not driven by any other area of your site, such as forums. For this you can use the databases part of our pages application. The following 2 guides discuss databases and how to create them within your ACP. Databases are added, and connected to only one page. In this example we would be using your home page. Note, this is not to be confused with being able to add feeds from a database, which you can do in various places around the site. You would add a database to your site once created, using the block manager. Once added, you can select the database you have created, as shown below Database Selection By default this would show the categories of your database, as you can see in the background of the above image. For our purposes, we only have one category named articles, and want these to show up on the page itself, rather than showing the category name. In order to do this, you would need to edit the database you have created, and change its 'Database index' setting so 'Show as Articles'. This would the give an article layout to your database. Database in article layout More advanced options For our more advanced users, pages can be created in the 'Manual HTML' style editor, which you would select instead of using the 'Page Builder' option, when creating a page. Manual HTML One important option here for advanced users, is the 'Use suite HTML wrapper' option. If this is selected, you would be creating HTML within the suite wrapper. So you would already have the standard site header, footer, CSS, includes etc. This can be helpful if you want to add content within the page itself. If you do not choose this option, then you would be responsible for the whole page, including the doctype, head, body etc. All html content for the HTML version of a page would be added to the content tab.
×
×
  • Create New...