Next File Manager 6.1.0: share links, Trash, a phone app and a Health check Next Exams 6.3.0: exam parts, scaled scores, listening and speaking tests Next Restaurant 6.1.0: move your data in, run payroll, and connect other systems Next Inventory 6.2.0: a REST API and webhooks for your other systems Next DB 6.1: Auto-Updating Tables, Printing, Phone Layout and SEO Next Task 6.0.0: a task manager for Joomla
NextSoftware

Troubleshooting

Common symptoms, what causes them, and how to fix them.


Emails are not sent, holds never expire, balances are not charged

Background jobs are not running.

  1. Joomla's scheduler is not running. Everything in the background (expiring holds, sending queued emails and texts, charging balances, placing damage deposit holds, reading iCal calendars, running automations, drafting statements) is a Joomla Scheduled Task. Open System > Manage > Scheduled Tasks and check the Next Self-Catering tasks are enabled and have a recent Last Run. If none of them ran, turn on the Lazy Scheduler in that page's Options, or set up a web cron or server cron for Joomla's scheduler. See Scheduled tasks.
  2. A quiet site with the lazy scheduler. The lazy scheduler only runs when someone visits the site. On a site with few visitors, use a web cron or server cron instead, so a balance due at night is still charged.
  3. A task was deleted or disabled. Reinstall the package over the top: the installer recreates missing Next Self-Catering tasks.
  4. The email failed. Open Configure > Emails, tab Sent and queued. A message marked Gave up shows its error; fix the cause (usually Joomla's mail settings in System > Global Configuration > Server) and click Retry.
  5. Links in emails are missing or wrong. Set Website address under Configure > Settings > Email. It is filled in on your first visit there and must be changed if the site moves.

Online payment is not offered at checkout

Guests see "Online payment is not available for this property. Please contact us to book."

  1. No published method. Open Configure > Payment methods. At least one method must exist and be published.
  2. The plugin's app is off. A method whose plugin is switched off in Configure > Apps shows an App off chip and is not offered. Turn the app on.
  3. The plugin is disabled. If the page says "The plugin of this method is not installed or not enabled", enable it in System > Manage > Plugins.
  4. Keys missing for the current mode. A Stripe method is not offered until the publishable key, secret key and webhook signing secret of its mode (test or live) are all set. A PayPal method needs the client ID, secret and webhook ID of its mode. Press Test connection: it lists what is still missing. See Payment methods.
  5. Bank transfer instructions are empty. The bank transfer method is not offered while its Instructions field is empty.
  6. Currency not allowed. A method limited to certain currencies is only offered for properties priced in one of them, and Stripe and PayPal only accept the currencies they support.

Test connection fails for Stripe or PayPal

The method's Test connection reports an error.

  1. "This is not a test secret key" or "This is not a live secret key": the key does not match the Test mode switch. Test mode needs keys starting sk_test_ or rk_test_; live mode needs sk_live_ or rk_live_.
  2. "Stripe refused the key.": the key was revoked, mistyped or belongs to another account. Copy it again from Stripe Dashboard > Developers > API keys.
  3. "PayPal refused the credentials.": the client ID and secret must come from the same app, sandbox for test mode and live for live mode, in the PayPal Developer Dashboard.
  4. "Could not be reached": the server cannot make outgoing HTTPS requests. Ask your host to allow outbound connections to Stripe and PayPal, and check PHP has the cURL extension.

A guest paid but the booking is still held

The money arrived at Stripe or PayPal, but the booking did not confirm.

  1. The webhook is not registered. Copy the address on the method's Webhook tab and add it in the provider's dashboard with the events listed in Stripe or PayPal. Without it, a payment is only confirmed if the guest returns to your site.
  2. The site is not reachable. Webhooks need a public HTTPS address. A local, password-protected or firewalled site never receives them.
  3. Wrong webhook secret or ID. The webhook signing secret (Stripe) or webhook ID (PayPal) must be the one for the current mode. Test and live webhooks have different values.
  4. The hold ran out first. If the hold expired before the payment arrived and the nights are still free, the booking is confirmed by the late payment. If the nights were taken meanwhile, the booking shows a warning that a refund may be owed: check the transactions and refund.

Dates cannot be booked

The calendar or the quote refuses the stay.

  1. "Some of these nights are already taken.": another booking, a hold, an owner block, maintenance or an imported iCal stay already holds a night. Check the Tape chart.
  2. "Some nights have no price.": no season the property has a price in covers those nights. Add a season or extend one under Rentals > Seasons, then price it on Rentals > Rates & Availability.
  3. "Arrivals are not possible on that day." or "The stay is shorter than the minimum.": the booking rules for that season set changeover days and stay lengths. Use Price check on the rates page to see every reason at once. See Rates and availability.
  4. "Book further ahead for this date." or "Same-day bookings have closed.": the booking window or the same-day cutoff applies, in the property's own time zone.
  5. "Too close to another booking.": buffer nights keep free nights between stays.
  6. Search finds nothing for some dates. Many properties change over on set days, so a Wednesday-to-Sunday search finds nothing at a Saturday-changeover property. The search also only looks as far ahead as Days ahead to search under Configure > Settings > Search and map.

An iCal calendar is not read

Calendar sync shows a failure next to a calendar.

  1. "The calendar answered HTTP 404" (or another code): the channel no longer serves that address. Copy a fresh export address from the channel and edit the calendar.
  2. "Could not reach the calendar.": the channel was down, or your server cannot make outgoing HTTPS requests. Use Read now to try again.
  3. "This calendar address points to a private network and cannot be read.": only public addresses are read. Use the channel's public iCal link.
  4. "Reading calendars needs the PHP cURL extension.": ask your host to enable cURL.
  5. "The calendar is larger than ... MB." or "redirects too many times": the address is not a normal booking calendar. Check you copied the export link, not a web page.

While a calendar fails, the dates from its last good read stay blocked, so nothing is sold by mistake. If a channel does not see your own bookings, check you pasted the property's export link from Calendar sync into the channel: channels read it on their own schedule. See iCal sync.


Text messages are not sent

Automations run but no SMS arrives.

  1. The SMS app is off. Switch on SMS in Configure > Apps.
  2. No default profile. On Configure > SMS gateways, one published profile must be the Default. Without one, automations send no texts.
  3. Test mode is on. A profile in test mode only writes each message to the Joomla log and counts it as sent. Switch test mode off to send for real.
  4. The number has no country code. Numbers need the international form (+44 7700 900123), or set a Default country code on Configure > SMS gateways for numbers entered without one.
  5. The HTTP gateway reports success wrongly or not at all. Some providers answer 200 OK even when they refuse a message. Set the gateway's Success text to something their answer always contains when a message is accepted, and use Send test SMS to check. See SMS gateways.

A page is missing or access is refused

A menu item is missing in the admin, or a page says "You do not have permission to see this page."

  1. The app is switched off. A switched-off app hides its pages and shows "This feature is switched off." Turn it on in Configure > Apps.
  2. The staff role does not grant it. Open Configure > Staff roles and check the user's role has View (or Manage) on that area. A role given to a user directly replaces the roles of their groups.
  3. The user cannot open the component. A role alone does not let a user into the admin. In Next Self-Catering Options > Permissions, set Access Administration Interface to Allowed for their group, which also needs Administrator Login in Global Configuration. The same applies to the Manage App on the site. See Roles and permissions.

An owner statement cannot be finalised

"This month has not ended yet. The statement stays a draft until then, so stays still to come are not left out."

The current month can be drafted as a preview, but only finalised from the first day of the next month, on the site's time zone (Global Configuration > Server > Website Time Zone). Regenerate the draft then and finalise it.

"This month has not started yet. Choose the current month or an earlier one." Statements are made for months that have begun; pick the month again in Generate statements.


Cleaners cannot sign in

A housekeeper's link, PIN or device does not work.

  1. The link was renewed. A private link stops working when a new one is made. Send them the current link with Email link on their housekeeper record.
  2. The PIN is locked. Too many wrong PINs lock sign-in for a few minutes. Setting a new PIN unlocks it.
  3. PIN sign-in is limited to paired devices. Under Configure > Settings > Housekeeping, Paired devices only means a PIN works only on devices you paired. Pair the device, or allow email and PIN on any device.
  4. The device was revoked or re-paired. Pair it again from Rentals > Housekeeping > Devices.
  5. The housekeeper is inactive. An inactive housekeeper cannot open their jobs.

Guests cannot create an account, or their bookings are missing from My bookings

  1. No "Create an account" box at checkout. It shows only when Users > Options > Allow User Registration is Yes and the visitor is not logged in. With Guests must log in to book on, visitors register on Joomla's own login page instead.
  2. "There is already an account with this email address." The guest has an account: they log in first, or book without creating one.
  3. The account waits for activation. With New User Account Activation set to Self or Administrator, Joomla emails the activation link (and the administrators, for Administrator). The booking is placed either way.
  4. Earlier bookings are not listed. Bookings made before the account, or with another email address, are not added automatically: under My bookings, the guest asks for the link sent to that address and opens it while logged in (it works for 24 hours). Staff can instead link the guest record to the account on the guest form. The link is sent by the email task, so the scheduler must be running (see the first section). Bookings made while logged in are always listed. An account's email address alone never links the guest's details, because Joomla does not check a changed address (nor a new one when activation is None): the first time a guest saves their contact details, they are asked for that link to their own address. An account created at checkout with activation on, or created by staff, is linked straight away.
  5. Joomla also sent "New User Details" when staff created an account. That is Joomla's own email; switch off Notification Mail to User in the User - Joomla! plugin if you only want Next Self-Catering's invitation.

The map shows OpenStreetMap instead of Google Maps

Google Maps is chosen but the site still shows OpenStreetMap.

  1. No API key. Google Maps needs a browser key with the Maps JavaScript API under Configure > Settings > Search and map. Until one is set the site falls back to OpenStreetMap.
  2. The key is restricted to another address. Restrict the key to your site's own address in the Google Cloud console. See Google Maps.

A template override or my own layout does not show

The page looks the same, or my layout is not in the pickers.

  1. Wrong folder. Component layouts go in templates/<template>/html/layouts/com_nextselfcatering/<kind>/<name>.php, module templates in templates/<template>/html/mod_nextselfcatering_<name>/<file>.php.
  2. Another template style. The override must be in the template the page uses. Check the menu item's Template Style.
  3. A kind that takes no new layouts. Only card, list, filter, property and pagination layouts show in the pickers. Sections and parts can be overridden, not added.
  4. New classes do nothing. Classes that are not in the built stylesheet have no style. Put your styles in the template's CSS. See Template Overrides.
  5. The filter, paging or map stopped working. The override dropped a data-nsc-* attribute or renamed a field. Compare it with the original file.

There is no map beside the properties list

The Properties list shows no map.

The map is a module. Publish the Map module on the Properties list page and set its Mode to Linked to the Properties list on the page. On any other page use On its own. See Site modules.


The price filter does not show

The filter has no price slider.

The price range comes from the search index. On a new site, or after large price changes, it may be empty until the Refresh the search index task has run. Check the task under System > Manage > Scheduled Tasks, or run it now.


A landing page address opens the wrong page or a 404

  1. Not published, or another language. Check the landing page under Configure > Settings > Links (SEF). A landing for one language does not open in another.
  2. Not below a Properties list. A landing address works only below a Properties list menu item.
  3. More than one filter. A list filtered by more than one location, type or feature has no landing page. It keeps its normal address.

Wishlist hearts do not show

Cards have no heart.

  1. No script. Hearts need JavaScript. Without it they stay hidden.
  2. Browser storage blocked. In a private window a guest's list may not be kept between pages. Signing in keeps it in the account.
  3. Own card layout. An overridden card must keep its button[data-nsc-wishlist].

The Manage App says access denied

A staff member opens the Manage App page and gets an access error, or the login page.

  1. Not signed in. The page sends visitors to the login page first.
  2. No administrator rights. The person's group needs Administrator Login in System > Global Configuration > Permissions and Access Administration Interface in Next Self-Catering Options > Permissions. The Manage App gives no one more than the administrator would. See Manage App.

Inspection photos open for anyone on nginx

A photo's address under media/nextselfcatering-private opens without signing in.

nginx ignores the .htaccess file that protects the folder on Apache. Add the deny rule from Compatibility to your server block and reload nginx.


Joomla Update System

Updates are not found or downloads fail.

  1. Download key. Enter your download key in System > Update > Update Sites on the Next Self-Catering Updates entry.
  2. Expired subscription. Updates are delivered while your licence is active. Renew it on nextsoftware.dev.
  3. Server unreachable. Make sure your server can reach nextsoftware.dev. Some hosts block outbound HTTPS connections.

All Extensions