What's in the website folder and what not to touch
This guide is for you if your website is on your own hosting, not with us, and you look at its files in the hosting control panel or your hosting company asks you for them. For everyday use you don't need the folder: you make any change to the website from the admin panel.
How to find the website folder
- Sign in to the hosting control panel (for example cPanel or DirectAdmin) and open File Manager.
- Look for the folder where you see the admin, api and data folders side by side. Usually it's public_html. That's where the website and the admin panel live together, with no database: everything is in files.
What's in each folder
- .htaccess (the one in the main folder, next to admin): sends each address on the website to the right page and holds your redirects.
- VERSION.json: the installed version, so we know which update comes next.
- admin: the admin panel, the one you open at your-business.ro/admin/.
- api: the "engine" behind the admin panel and the website's forms (saves, contact requests, payments).
- lib: the website's shared code.
- addons: the add-ons' code, for example SEO or the website's languages. It's there on every website, but an add-on starts only after you buy it.
- tools: maintenance tools, run automatically or by us, for example the backups or the checks made every 5 minutes.
- rollback.php and, after the first update, the _rollback folder: the code restore points, made by us before each update.
- data: your website's data.
- public: the website visitors see (the finished pages and the images);
- base: the template the pages are rebuilt from;
- media: the photos you uploaded from the admin panel;
- the .json files: the texts, services, team, opening hours, settings, languages, that is everything you edit from the admin panel;
- history: the restore points for the texts (in the admin panel, under History);
- _private and the files that start with a dot: the website's secrets (the admin panel password, the link to the WebID account, the connection details, encrypted).
The data folder is protected by its own .htaccess file: the .json files, hidden files and scripts in it can't be opened from the internet. The protection works only if the hosting reads .htaccess files (AllowOverride All, from the list below).
What not to touch
- Don't open, move or send anyone the _private folder and the files in data that start with a dot. Not even us, by email.
- Don't change or delete the .htaccess in the main folder: without it, the website's pages show errors or lists of files.
- Don't change anything in admin, api, lib, addons and tools: they're written again with every update, and whatever you changed is lost.
- Don't change the pages in public: they're rebuilt at the next save from the admin panel, and your change disappears. Change the text from the admin panel.
- Don't move the folder to move the website to another domain: the website address is written into the pages. We do the move: write to us at contact@webid.ro.
What to tell your hosting company
If your hosting company asks you what the website needs, send them this list:
- PHP 8.1 or newer, with the mbstring, gd, zip, curl and openssl extensions;
- Apache 2.4 or newer, or LiteSpeed, with mod_rewrite on and AllowOverride All;
- write permission for PHP in the data folder (that's where everything you change from the admin panel is saved).
How backups and updates work
- At installation, we set up backups of the whole folder with your hosting company. From then on, the hosting company makes them; if you want, you can also make a copy of the folder yourself anytime.
- Texts and settings have, separately, their own restore points, in the admin panel: Advanced, then History.
- We upload the updates, always complete, never a single file. A regular update changes only the code and doesn't touch the data folder.
- Before each update, we make a code restore point. The restore points are on the website's rollback.php page, which asks for the website's admin panel password (not the hosting one). The last 3 are kept.
Common problems
- "The admin panel doesn't save or shows an error when saving." The website isn't allowed to write to the data folder. Ask your hosting company for write permission for PHP in the data folder.
- "The home page works, but the others show a 404 error." The .htaccess in the main folder is missing or the hosting has mod_rewrite off. Ask your hosting company to turn on mod_rewrite and AllowOverride All; don't delete .htaccess.
- "I deleted something from the folder by mistake." Don't upload anything over it. If it's something in data (texts, photos, settings), ask your hosting company to bring it back from their backup: our copy is from the installation. If it's code (admin, api, lib, addons, tools), write to us at contact@webid.ro and we'll upload it again.
- "The hosting antivirus quarantined a file from tools." The files in tools are the website's regular maintenance tools, but don't restore the file on trust. Ask your hosting company for the file name and what the antivirus found, send them to us at contact@webid.ro and we'll tell you whether it can be restored.
- "The admin panel says the website isn't linked to the WebID account." The link, a hidden file in data, is missing. Don't recreate it yourself: write to us at contact@webid.ro.
- "I lost the phone I used to sign in to the admin panel." Use the guide "I lost access to my admin panel": it shows you the emergency file you put in data. Don't do anything else in the folder.
- "Something else isn't working." Write to us at contact@webid.ro with what you see on the screen and we'll take a look.
What it doesn't do
- The admin panel doesn't show you the hosting status (free space, PHP version). You see them in the hosting control panel. If you have maintenance, we check the website every 5 minutes and write to you if it doesn't respond - see What maintenance does for you.
- There's no database to export. If you want a copy of the website, you copy the whole folder, data included.
- It doesn't keep changes made directly in the files: they're lost at the next save from the admin panel or at the next update.
What data it uses
The folder holds all the website's data: the texts, the photos, your colleagues' accounts, the "Who did what" log and the requests received through the form. On your own hosting, its security is up to you and your provider, and you don't send the _private/ folder and the files that start with a dot to anyone, not even us. What we process on your behalf is in DPA §3 and §6.