Vehicles Site¶
The Vehicles Site is a full GTA V vehicle database for your server — browse, filter, compare, and manage all vehicles. It has a public-facing catalogue and a full admin dashboard for managing vehicle data, members, Discord integration, and site settings.
Local (dev): http://localhost/raycin_vehicles/
Live: https://raycin.com/raycin-gta-vehicles-database/ (or your URL)
Public Pages¶
Home /¶
Landing page with featured vehicles and a search bar. Highlights the most recently added or featured vehicles.
Vehicles /vehicles¶
The full vehicle catalogue. Every vehicle in the database appears here as a card showing: - Vehicle image (if available) - Name, manufacturer, and class - Tier classification - DLC tag - Model spawn name (click to copy to clipboard — useful for server admin commands)
Filtering¶
Multiple filter types can be combined:
| Filter | How to use |
|---|---|
| Class | Click a class button (Sports, Super, Off-Road, etc.) |
| Manufacturer | Click a manufacturer button (Vapid, Grotti, etc.) |
| DLC | Click a DLC pack name |
| Tier | Click a tier (S, A, B, C, D) |
| Tag | Click a tag (Convertible, 4WD, etc.) |
| Search | Type in the search box — filters update automatically |
Clicking a filter button applies it immediately — no need to click a submit button. Click the active button again to clear that filter.
Vehicle Detail /vehicles/{slug}¶
Click any vehicle card to open its full detail page:
- Full specification sheet
- All assigned tags, DLC, manufacturer, class, and tier
- GTA V spawn name with copy button
- Gallery images (if uploaded)
- Any lore/description text
Favourites /favourites¶
Vehicles you have starred are saved in your browser's local storage and shown here. Starred vehicles appear across sessions (until you clear browser storage).
Compare /compare¶
Compare up to 4 vehicles side by side.
How to use: 1. Browse to any vehicle card and click the Compare button (the ⊕ icon) 2. A floating compare bar appears at the bottom of the screen showing how many vehicles are in your compare selection 3. Add up to 4 vehicles, then click Compare in the floating bar 4. The comparison table shows all specs side by side
Filter pages¶
Shortcut pages that pre-apply a single filter:
| URL | Shows |
|---|---|
/class/sports |
All Sports class vehicles |
/manufacturer/vapid |
All Vapid vehicles |
/tag/convertible |
All Convertible tagged vehicles |
/tier/s |
All S-tier vehicles |
/dlc/criminal-enterprises |
Vehicles from a specific DLC pack |
Admin Dashboard¶
Logging in¶
Go to /raycin_vehicles/admin/login (link auto-adapts to whatever domain you're hosting from — localhost in dev, your live domain in production).
Enter your admin username and password. Sessions last 8 hours — you will be logged out automatically after that. All admin pages use CSRF protection, so do not share your login session or use browser auto-fill across different computers.
Forgot your password?¶
Passwords are stored as secure bcrypt hashes — they cannot be read from the database. To reset:
- Make sure XAMPP (Apache + MySQL) is running
- Visit /raycin_vehicles/reset-admin.php
- Select your admin account from the dropdown (if there are multiple)
- Enter a new password (minimum 8 characters) and confirm it
- Click Set New Password
- Log in at
/admin/loginwith the new password - ⚠️ Delete
reset-admin.phpfromC:\xampp\htdocs\raycin_vehicles\immediately — it has no authentication of its own
Note:
reset-admin.phpis a utility file included with this installation for exactly this situation. It must be deleted after use.
Admin sections overview¶
| Section | URL | Purpose |
|---|---|---|
| Dashboard | /admin |
Stats, recent activity, data-completeness warnings |
| Vehicles | /admin/vehicles |
Full vehicle CRUD, images, bulk ops |
| Classes | /admin/classes |
Manage vehicle classes |
| Tags | /admin/tags |
Manage tags |
| Manufacturers | /admin/manufacturers |
Manage manufacturers |
| Members | /admin/members |
Approve, suspend, delete members |
| Discord | /admin/discord |
Webhook config, test, logs |
| Todo | /admin/todo |
Internal task list |
| Rentals | /admin/rentals |
Server rental booking management |
| Whitelist | /admin/whitelist |
Read-only view of FiveM whitelist |
| Settings | /admin/settings |
Site-wide configuration values |
| Images | /admin/images |
Batch-download vehicle images |
| Lore Manager | /admin/lore |
FiveM vehicle resource management |
| Sync | /admin/sync |
Sync FiveM vehicle data into website DB |
| Dev Tools | /dev |
Export, print, race track types |
Dashboard /admin¶
Overview panel showing at a glance: - Total vehicles (published vs draft) - Class count, manufacturer count - Data completeness warnings — vehicles missing images, speed specs, prices, or race tiers are flagged here so you know what needs filling in - Recent 10 vehicles added or updated
Vehicles /admin/vehicles¶
Full vehicle management — the core of the admin panel.
Adding a vehicle¶
- Click Add Vehicle
- Fill in: Name, Class, Manufacturer, Tier, DLC, Spawn name, Description
- Assign Tags (you can select multiple)
- Upload images (main image + gallery images)
- Click Save
Editing a vehicle¶
- Click the vehicle in the list
- Edit any field
- Click Save
Featured toggle¶
Tick the Featured checkbox on any vehicle to pin it to the top of the public catalogue homepage.
Bulk update¶
Select multiple vehicles using the checkboxes, then use the Bulk Update dropdown to change class, tier, or other fields across all selected vehicles at once.
Classes /admin/classes¶
Manage the vehicle class list (Sports, Super, Muscle, etc.).
- Add a class: click Add Class, enter a name and slug
- Edit or delete existing classes
- Classes appear as filter buttons on the public
/vehiclespage
Manufacturers /admin/manufacturers¶
Manage manufacturer entries (Vapid, Bravado, Grotti, etc.).
- Add, edit, or delete manufacturers
- Manufacturers appear as filter buttons on the public page
Tags /admin/tags¶
Manage vehicle tags (Convertible, 4WD, Race, etc.).
- Tags are flexible labels you create — add as many as needed
- Assigned to vehicles via the vehicle edit form
Settings /admin/settings¶
Site-wide configuration.
| Setting | Description |
|---|---|
| Site name | Shown in browser tab and page title |
| Site URL | Your live domain (used for canonical links) |
| Vehicles per page | How many vehicle cards appear per page |
| Member registration | Open / Invite-only / Closed |
| Featured vehicles | How many show on the homepage |
Members /admin/members¶
Manage registered members of the vehicles site.
| Action | How |
|---|---|
| Approve a pending registration | Click Approve on the member row |
| Suspend a member | Click Suspend — they cannot log in while suspended |
| Update role or display name | Click Edit |
| Delete a member | Click Delete (permanent) |
Discord Integration /admin/discord¶
Connect the vehicles site to a Discord channel for notifications.
Setup: 1. Create a webhook in your Discord server (Server Settings → Integrations → Webhooks → New Webhook) 2. Copy the webhook URL 3. Paste it in Webhook URL and click Save 4. Click Test to send a test message and confirm it works 5. Click Clear Log to empty the notification history
Once configured, Discord receives a notification when vehicles are added or other configured events fire.
Lore Manager /admin/lore¶
Manages the rralan_lffv FiveM resource — the in-game vehicle lore database. This keeps your in-game vehicle information (names, descriptions, stats) in sync with the website database.
| Action | Description |
|---|---|
| Validate | Check the lore JSON for errors |
| Add vehicle | Add a new vehicle entry to the lore resource |
| Edit | Edit an existing lore vehicle — opens a form with all fields |
| Diff | Shows what changed since the last save (line-by-line comparison) |
| Backups | Create / restore snapshots of the lore data |
| Clone | Duplicate an existing vehicle as a starting point for a new one |
| Export | Download the lore data as JSON or CSV |
Image Manager /admin/images¶
Download and optionally watermark vehicle images.
| Action | Description |
|---|---|
| Download All | Bulk-download all vehicle images |
| Download single | Download the image for one specific vehicle |
| Gallery Download All | Bulk-download gallery (additional) images |
Watermarks are applied automatically to images during download if enabled in Settings.
Todo List /admin/todo¶
Internal task tracker — private to the admin panel, not visible to the public.
- Add a task — enter title, body (details), category, and priority (Critical / High / Medium / Low)
- Update status — move tasks between To Do → In Progress → Done
- Filter — view active only, completed only, or all tasks; filter by category
- Delete — remove tasks when no longer relevant
Use this to track pending vehicle additions, image downloads needed, or any other admin work.
Rentals /admin/rentals¶
View and manage server rental bookings (if the rental system is active on your FiveM server).
- Lists all bookings with status: Pending / Active / Completed / Cancelled
- Status is automatically updated based on the booking start/end times
- Cancel a booking: marks it cancelled, expires the whitelist entry in the FiveM database, and sends a Discord notification (if webhook is configured)
- Status counts shown at the top so you can see how many are in each state at a glance
Whitelist /admin/whitelist¶
Read-only view of the raycin_whitelist table in the FiveM database. This is for reference only — changes to the whitelist must be made through the FiveM server or the approved workflow.
Filters: - By role (e.g. Member, VIP, Staff) - By status (approved, pending, banned) - Search by player name or license
Shows: license, name, role, status, who approved them, join date, notes. Paginated at 50 per page.
Settings /admin/settings¶
Key-value configuration store for the site. Settings are grouped by category.
| Setting | What it controls |
|---|---|
| Members require approval | If ON, new registrations wait for admin approval before they can log in |
| Site tagline | Subtitle shown under the site name |
| Donation links | Ko-fi, PayPal, and Patreon URLs shown on the Donate page |
| Donation page message | Text shown on the Donate page above the buttons |
| Feature access levels | Which features require member login vs public access |
To change a setting: find it in the list, click the value field, update it, and save.
Sync /admin/sync¶
Database sync dashboard — reconciles the vehicle site database with your FiveM server's vehicle list.
Use this after adding new vehicles to FiveM to pull them into the website database automatically.
Dev Tools /dev¶
Developer utilities — only accessible to admin users.
| Tool | Description |
|---|---|
| Race Track Types | Editor for race-related track type data |
| Export JSON | Download the full vehicle DB as a JSON file |
| Export CSV | Download as CSV (for spreadsheets) |
| Export Menu Lua | Generate a Lua file suitable for use as a FiveM menu config |
| Print Tiers | Print-formatted tier list |
Dark / Light Mode¶
A ☀ / 🌙 toggle button appears on every public page. Click it to switch between dark mode (default) and light mode. The preference is remembered between visits.
WordPress Integration¶
The Vehicles site can be linked from within WordPress pages, but unlike the Stats site it does not have a built-in WordPress wrapper. The recommended approach is:
- Create a WordPress page (e.g. "Vehicle Database") with a title and intro text
- Add a button or link pointing to your vehicles site URL
- Style it to match using the same dark theme palette:
- Background:
#0d0f18 - Card background:
#12141c - Accent gold:
#f6c90e - Text:
#eef0f5
If you want the vehicles site to appear fully inside the WordPress theme (with header/footer), the same wrapper approach used for the Stats site applies — create an
index.phpthat loadswp-load.phpand outputsget_header()/get_footer()around the main vehicles app content. Contact the developer if you want this set up.
Making your WordPress site match the dark theme¶
Both the Stats and Vehicles sites use the same colour palette. To apply this look to your main WordPress site:
Colour reference¶
| Token | Value | Use |
|---|---|---|
| Background | #0d0f18 |
Page background |
| Card | #12141c |
Section / widget backgrounds |
| Card border | #252836 |
Borders, dividers |
| Gold accent | #f6c90e |
Headings, highlights, buttons |
| Text | #eef0f5 |
Body text |
| Muted text | #8892a4 |
Labels, secondary info |
| Success green | #3fb950 |
Positive values, active badges |
| Error red | #f85149 |
Errors, DNF, negative |
Applying to WordPress (Impreza theme)¶
- Go to WordPress Admin → Appearance → Customize → Colors
- Set the main background to
#0d0f18 - Set header background to
#0d0f18 - Set accent / button colour to
#f6c90e - Set body text to
#eef0f5
For deeper customisation, add this to Appearance → Customize → Additional CSS:
/* Match site-wide dark theme */
body { background: #0d0f18; color: #eef0f5; }
.wpb_wrapper, .vc_column-inner { background: transparent; }
.entry-title, h1, h2, h3 { color: #f6c90e; }
a { color: #f6c90e; }
a:hover { color: #ffd94a; }
/* Cards / widgets */
.widget, .vc_column_container { background: #12141c; border: 1px solid #252836; border-radius: 8px; }
Tip: The Stats site's
index.phpWordPress wrapper already handles header colour matching automatically via the--header-heightCSS variable andbody.cr-stats-wrappedoverrides — you only need to adjust the base WordPress theme colours for the rest of the site to match.