Troubleshooting — KorDent HTML
Most problems with the KorDent HTML edition come from a wrong path, a class missing from the stylesheet or a form endpoint not set. Those answers come first.
Then come the questions buyers ask most.
Errors you may hit
Section titled “Errors you may hit”The page looks unstyled.
The page can’t find assets/css/style.css. In a page inside a folder (service/, blog/, legal/) the path starts
with ../; in 404.html with /. Check the <link rel="stylesheet"> of the page.
An image doesn’t appear.
The src doesn’t match the file: same spelling, same extension (.jpg is not .jpeg), and ../ in front from inside
a folder. File names are case-sensitive on most hosts, even when they are not on your computer.
A photo is cropped in the wrong place. Every photo sits in a frame and is cropped to fill it from the centre, and the frames change shape between phone, tablet and desktop. Crop the photo to the shape you want and keep the subject away from the edges (Editing the site).
A class I added does nothing.
assets/css/style.css holds only the classes the site used when it was built. Rebuild it: npm install once, then
npm run build:css (Making it look like your brand).
A title, a block or a whole section stays invisible.
Blocks that rise into view start invisible (style="opacity: 0.001; …") and wait for the script. Check that the page
still loads assets/js/main.js (with ../ from inside a folder) and that the browser console shows no error. To show a
block without the effect, remove its data-appear and its style (Editing the site).
I changed something, but another page still shows the old version. Blocks are copies, not references: change every page that holds one (Editing the site).
The menu, the tabs, the filter, the accordions or the booking form stopped working.
They are wired to assets/js/main.js by their data-… attributes. If you copied or rewrote one, keep those attributes
(Making it look like your brand), and check the console for an error.
The service filter shows a service under the wrong tab, or the search misses it.
A card’s data-category must be its department’s slug (the data-filter-tab of the tab), and its data-title the
name in lower case: the search looks there.
A new service doesn’t show in a grid.
A grid shows at most data-limit services: 6 on Home and on the service pages, 14 on service.html. Raise it, or pick
the service with its tab.
The booking form lists no dentist for a treatment.
The treatment’s data-booking-service lists the dentists’ slugs, separated by commas; each must match the
data-booking-doctor of a dentist in the same form (Forms).
A form says “Something went wrong”.
The form service answered with an error, or the endpoint is wrong. The browser console shows the reason after
[forms] could not send the form. Check formEndpoint (and formAccessKey for Web3Forms) in assets/js/config.js,
and that the form is active at the service.
A form shows “Thank you” but nothing arrives.
formEndpoint is empty, so the forms are in demo mode: set it (Forms). If you added a field named fax,
rename it: that name is the hidden spam trap, and a form that fills it sends nothing.
“Call Now” dials the demo’s number. The phone numbers are written into the links of every page: search the folder for “555” and replace each, as shown and as dialled (Editing the site).
The map on Contact shows the wrong place.
The address is written URL-encoded in the map’s src and in “Get Direction”’s href: replace both
(Editing the site).
The video does not play.
It plays when the call to action is on the screen, muted and in a loop, and never for visitors who prefer reduced
motion. If it doesn’t play for you either, check its src (assets/videos/cta.mp4, ../assets/… from blog/) and
that the file is an MP4 the browser can play.
Clicking a link downloads a file or shows a directory listing.
The link leaves out .html (about instead of about.html), or points at a folder. Keep the file names in the links.
The share image or title is the old one.
Facebook, LinkedIn and X cache them. Use their debuggers to refresh, and confirm that the og: tags carry your domain.
Questions
Section titled “Questions”Do I need Node.js or a build step? No, to edit and publish. Only to rebuild the stylesheet after using new classes or changing the theme.
Can I use this template for a client? See License: that is the one place that answers it for your licence.
Can I remove the style guide, a page, a section or the video? Yes:
- the style guide: delete
style-guide.html; - a page: see Editing the site;
- a section: delete its
<section>…</section>inside<main>; - the video: Editing the site.
Can I change the fonts to my brand’s? Yes: Making it look like your brand.
Does the booking form connect to a calendar or practice software?
Not by itself: a booking is a request that reaches you through your form service. Send it on to your practice software
or a scheduling tool through a webhook (Zapier, Make), or replace the form on book.html with your booking tool’s embed.
Can I write the site in another language?
All the copy is in the HTML, so write it in your language. Then set lang on the <html> of every page and
og:locale in the <head>. The template has no language switch.
Does the site need JavaScript?
For the menu on phones, the tabs, the filter, the accordions, the motion and the forms, yes: one script,
assets/js/main.js. Without JavaScript the text and the blocks still show.
Does the site need a cookie banner? As shipped, the template sets no cookies of its own and the font is served from your own domain. The Contact page embeds a Google Maps view, which loads from Google and may set Google’s cookies; declare it, or replace it with a static picture and the “Get Direction” link. Your form service and any analytics you add are yours to declare too. The demo’s Privacy Policy is a sample: edit it to match what your site does.
Can I use it with WordPress, Webflow or a site builder? Not directly: it is a hand-coded site. You can copy sections into a builder that accepts custom HTML, but each builder has its own way of doing things.
Can I connect a CMS? See Editing without touching HTML: the options, and why the Astro and Next.js editions are the shorter road.
How do I update to a new version of the template?
Download the new release and compare it with your copy; CHANGELOG.md lists what changed. Move your text and images
into the new pages, or apply the listed changes to yours.
Can you customise it for me, or build my site? Yes. Marcframe, the studio behind this template, updates templates to your needs (brand, content, new pages and features), builds custom templates and designs new websites. Get in touch at marcframe.com/contact or hire us on Contra.
Something is broken and none of this helps. Support and updates: https://framebrick.co/support. Send the page, the browser, and the error text or a screenshot: it makes the answer much faster.