Contents 

This document aims to answer your questions and offer advice on best practices. Here's what will be covered: 

 

Getting Started (Pre-Installation, Requirements, etc.) FAQs

Q: WHAT BROWSERS AND DEVICES DOES THE BIDJS CLIENT SUPPORT? 

A: BidJS currently supports the browsers mentioned in this document on all major mobile and desktop devices, however, we do not test against historic browser versions. We also cannot predict new version releases for each browser or the impact this may have on BidJS.
Upon any report of issues relating to specific devices, we will investigate the impact of the issue, and prioritise appropriately.


Q: WHERE DO I GET THE MY_STATIC_URL, MY_API_BASE_ENDPOINT AND MY_CLIENT_ID DETAILS FROM? (I.E. YOUR CONFIGURATION DETAILS
A:  We will send these to you once you have signed a contract with us. Until then, you can use the demonstration details, which can be emailed to you after your live demo.


Q: DO WE NEED TO MAKE ANY SERVER-SIDE CHANGES TO IMPLEMENT THE BIDJS CLIENT? 

A: No! We have implemented the page navigation on the BidJS Client using hashbangs, meaning that there is no server-side configuration required to resolve these URLs when linked to directly.


Q: DO I NEED TO MAKE ANY MAIL SETTINGS CHANGES TO ENSURE THAT EMAILS ARE DELIVERED PROPERLY? 

A: When your Webapp has been created, we will provide some DKIM and SPF details to add to your MXrecords for the domain you'll be wanting the emails to come from. This will help prevent the emails from being treated as spam by the recipient.


Q: CAN I USE AN IFRAME?

A: You can use an iFrame, however our software does not support use of an iFrame. This means you will likely experience issues such as tabs appearing incorrectly, mobile view being unpredictable, etc.

We do not recommend using an iFrame and cannot support you with any of the issues you encounter while using one.


Q: I'M ALREADY USING BOOTSTRAP, WHAT DO I DO? 

A: If you are already using Bootstrap, you need to implement the Minimal version of our code. You can find information about Standard vs Minimal code in the Dependencies section of our Technical Documentation.

(for example, seeing errors such as 

test.html:73 Uncaught TypeError: Cannot read property 'textContent' of nullat loadDeferredStyles (test.html:73)

or 

bid.min.js:1 Uncaught TypeError: $(...).on is not a functionat t (bid.min.js:1)at Object.initialize (bid.min.js:1)at constructor.<anonymous> (bid.min.js:1)at g (bid-dependencies.min.js:1)at m (bid-dependencies.min.js:1)(etc.)

)




Installation FAQS

Q: I'VE RUN THE CODE AND I CAN SEE LOADING SPINNER, BUT THE PAGE WON'T FINISH LOADING

A: This is usually a problem with the configuration details you have entered.

Check the details you have entered are correct and reload the page.


Q: I'M GETTING JAVASCRIPT ERRORS AND THE PAGE DOESN'T LOAD PROPERLY E.G. WEBCAST AUCTIONS LOAD OKAY BUT TIMED WILL NOT, ETC. 

For example I'm seeing an error such as:

TypeError: this.$el.tooltip is not a function[Learn More] TimedItemActions.js:123

A: Firstly, Your own version of bootstrap.js should be loaded AFTER the bid-dependencies--no-bootstrap.min.js file, so make sure you are loading in this order. 

The script has the “defer” property, which means that it gets loaded after page load. If your other scripts do not have this, the scripts will be loaded in the wrong order, and will give you errors.
To remedy this, remove the "defer" property from our scripts (or add it to yours) and reload.


Q: I CAN LOAD THE PAGE BUT IT DOESN'T LOOK RIGHT! 

A:You may have, for example, structures or containers on your site that change the appearance of the software. Check for these and make sure there is nothing in place that will affect appearance, such as container width restrictions.
You may also have some styling applied that automatically apply to the software. Check for this and change/suspend anything you do not want to apply here.


Q: I'M GETTING JQUERY CONFLICTS

A: We recommend you try running jQuery in non-conflict mode if you are using different versions of jQuery simultaneously. Please see this article for more information: https://stackoverflow.com/questions/1566595/can-i-use-multiple-versions-of-jquery-on-the-same-page

  

Q: IS THERE A TEST BIDLOGIX SERVER I CAN DEVELOP AND TEST AGAINST?

A: Most clients test their installation using our demonstration endpoints that are supplied at the point of receiving a demonstration from our sales team. You can also request access to the bidlogix staging configuration details for development and testing, however there will be cost involved with using our staging site. Get in touch with us via support@bidlogix.net for more information. 


Q: HOW DO I MAKE DEPENDENCIES (BUTTONS, LOGGED IN STATUS, ETC.) APPEAR ON OTHER PAGES

A: Some clients may wish to display BidJS navigation buttons or logged in status on pages that do not have the BidJS software. You can do this by installing a small BidJS module onto those pages and hiding it. Please see this document for further assistance: https://support.bidlogix.net/support/solutions/articles/44001812889-installing-bidjs-using-dependencies-on-non-bidjs-pages 

 

Q: HOW CAN I DISPLAY A WELCOME MESSAGE FOR MY USERS INCLUDING THEIR USERNAME? 

A: You can use the class "x-bidlogix--templated-


Q: I'VE GOT ALL THE DETAILS RIGHT BUT I'M SEEING A SERVER ERROR ON AN HTTP PAGE? 

A:  We do not support non-secure usage of our software. Please switch to HTTPS and you will see the site working. You can test this by changing the URL on the page you are attempting to access. 


Q: THE CHECKBOXES ARE MISSING FROM MY PAGE! 

A:  Usually this means that your theme or styling are overwriting certain elements on the page. In order to get the checkboxes working again, try adding something like -webkit-appearance: checkbox !important; into the input type="checkbox", as follows:


 

Buttons and Navigation FAQs

Q: I WANT MY NAV-BAR TO WORK ON PAGES WHERE THE SOFTWARE IS NOT EMBEDDED

A: If you design your nav-bar using direct links (such as https://bidjs.com/demo/#!/login) then you will see issues as we currently have a bug with the login modal collapsing. 

For now please use the following workaround so that your nav-bar buttons work on all pages: 

1. To make the nav-bar works correctly on a page where the software is embedded, make sure you're using the visual hooks as detailed in our documentation (for example, the hook for login would look something like this: <li class="x-bidlogix--authenticated-hide hidden"><a class="x-bidlogix--trigger-login clickable">Login</a></li>

2. Embed the software on every page you wish the login buttons to appear, but hide the software itself. The buttons will still work but the user will not see the software. We recommend using the mySales module for this purpose as it is likely to have the smallest impact on page loads etc. 

3. Make sure that the links in the triggers point to the pages where the software is visible, so that there are no issues with navigation. 

Please note that depending on your platform (such as WordPress) you may not be able to use the hooks directly, you may need to create something such as a menu item or object and give it the appropriate classes.


Q: I CAN SEE BUTTONS SUCH AS "ADMIN" BUT THEY'RE NOT DOING ANYTHING

A:You must make sure that your Visual Hooks are in place


Q: HOW DO I MAKE SURE VISUAL HOOKS WORK PROPERLY WITH WORDPRESS MENUS?

A: WordPress has a built in functionality for applying classes to li tags, but a few of our hooks need a class on the anchor tag. Assuming that the li element is the parent of the anchor, applying the class to the li will work fine.
(Our hooks simply hide or show the element and the contents within, the only exception to this is the Administrator hook and the displayName.)

Alternatively, you could make use of a third party plugin such as UberMenu.



Security FAQs

Q: WILL THE JS CLIENT HAVE CONTROL OVER ANYTHING ON MY WEBSITE

A: The JS Client will only influence the website where you specify BidJS Client Hooks
The majority of the custom styles required to make the BidJS Client function are namespaced, meaning they will not conflict with the styles of your website.


Q: WHEN USING MODULES, WHY AM I SEEING ERRORS WHEN I USE A SWITCH BETWEEN NON-SECURE AND SECURE WEBSITE PAGES

A: In the module config, you will have these two lines within your endpoints: 

apiBase: 'https://app7.bidlogix-production.com/auction-007/api', staticBase: 'https://app7.bidlogix-production.com/1.3'

Please remove the https: from the beginning of both apiBase and staticBase, so that they look like this: 

apiBase: '//app7.bidlogix-production.com/auction-007/api', staticBase: '//app7.bidlogix-production.com/1.3'

This allows the current web protocol to be absorbed by the endpoints.



SEO FAQs

Q: CAN SEARCH ENGINES CRAWL / INDEX OUR AUCTIONS IN THE BIDJS CLIENT? 

A: As the BidJS Client is completely client-side rendered, it is only indexed by Google at the time of writing. Other search engines have announced that they are working on Client-side rendering crawlers, but at the time of writing they are either not used, or used minimally.



Errors and Strange Behaviour FAQs

Q: WHEN I CLICK "LOGIN" THE POP-UP APPEARS BRIEFLY, BUT THEN DISAPPEARS AGAIN

A: This is to do with the structure of your URL. You must either use the trailing forward slash as follows: 

http://www.yourwebsitehere.com/content/auctions/

or you must use the #! structure: 

http://www.yourwebsitehere.com/content/auctions/#!/home

If the above does not work, you may have a problem with Bootstrap. 

Firstly, Your own version of bootstrap.js should be loaded AFTER the bid-dependencies--no-bootstrap.min.js file, so make sure you are loading in this order. 

The script has the “defer” property, which means that it gets loaded after page load. If your other scripts do not have this, the scripts will be loaded in the wrong order, and will give you errors.
To remedy this, remove the "defer" property from our scripts (or add it to yours) and reload.


Q: SOME CHARATERS ARE APPEARING INCORRECTLY / EXTRA CHARACTERS APPEARING 

A: It sounds like you are missing the element that causes the page to read Unicode. Make sure you have the following line of code in your page's <head> tags: 

<meta charset="utf-8"/>


Q: MY AUCTIONSARCHIVED PAGE IS GIVING ME A "PAGE DOES NOT EXIST" ERROR

A: You must make sure that you are using the correct urlPattern configuration for your site. If you are using an external object to point towards the auctionsArchived page (such as a nav bar outside of the embedded software) you will need to use the "pushState" urlPattern module option rather than the default "hash" setting.
You can find all the information on Module Options in the technical documentation.



Styling FAQs

Q: THE TEXT AND BUTTONS INSIDE THE LOT BOXES ARE MISS-ALIGNED> HOW CAN I MAKE SURE THEY LOOK GOOD?

A: Please add this code to your CSS:

.bidlogix-app .grid-item {
    display: -webkit-box !important;
    display: -ms-flexbox !important;
    display: flex !important;
}




Best Practice: Eliminating HTTP & HTTPS mixed content warnings

We've noticed that parent sites that include HTTP resources are being marked with a warning in Google's security audit tool. 

Further to this, Chrome's new interface will increase it's security awareness visible to the users from July 2018 (in Chrome v68). Make sure you eliminate mixed content and ensure that your site is properly secure. 


Source: https://www.theregister.co.uk/2018/02/08/google_chrome_http_shame/