📚 Admin Panel Guide

🏠 Admin Panel Overview

Welcome to the Ashie Resume | JobPortal admin panel. This comprehensive guide will help you configure and manage every aspect of your job portal.

Accessing the Admin Panel

To access the admin panel, you need to log in with an administrator account:

Admin Panel Sections

The admin panel is organized into the following main sections:

📊 Dashboard & Analytics

The admin dashboard provides a comprehensive overview of your job portal's performance, user activity, and key metrics.

Understanding Dashboard Metrics

Your dashboard displays the following key performance indicators:

Analytics Features

The analytics section provides detailed insights into:

• User Analytics: Registration trends, user roles distribution, active users
• Job Analytics: Popular categories, job posting frequency, application rates
• Revenue Analytics: Subscription sales, payment gateway performance, refund rates
• AI Usage: AI feature utilization, credits consumed, popular AI tools

🎨 Logo & Branding

Customize your platform's visual identity by uploading your logo, favicon, and other branding assets.

Uploading Your Logo

Your logo appears in the header navigation, footer, and throughout the platform. Here's how to upload it:

Branding Best Practices

🎭 Theme Customization

Personalize your platform's color scheme to match your brand identity. Changes apply instantly across the entire application.

Accessing Theme Settings

Navigate to Admin Panel → Settings → Theme to access the theme customization panel.

Available Color Options

You can customize three main colors that affect the entire platform:

How to Change Theme Colors

Reset to Default Colors

If you want to restore the original theme colors:

1. Click the "Reset / Refresh" button in the Theme Settings panel
2. Confirm the action when prompted
3. The default colors will be restored

🌐 Language Management

Make your job portal accessible to a global audience by adding multiple languages and configuring automatic translation services.

Accessing Language Settings

Navigate to Admin Panel → Settings → Language Management or go directly to Admin Panel → Languages (i18n) in the sidebar.

Adding a New Language

Auto-Translation Feature

The platform can automatically translate your content to new languages using translation APIs:

Configuring Translation Provider

Setting Default Language

The default language is what new visitors see when they first visit your site:

1. In the Language Management page, find your preferred default language
2. Click the star icon or "Set as Default" option
3. The default language will be marked with a special indicator

💳 Payment Gateway Configuration

Accept payments from customers worldwide by configuring one or more payment gateways. The platform supports 7 popular payment providers.

Supported Payment Gateways

Configuring a Payment Gateway

Gateway Credentials Reference

Enabling/Disabling Gateways

Each gateway has a toggle switch that controls whether it appears as a payment option for users:

• Enabled (Green): Gateway is available for customers to use
• Disabled (Gray): Gateway is configured but not shown to customers

Testing Payments

Before going live, always test your payment integration:

1. Configure the gateway in Sandbox/Test mode
2. Use the test credentials provided by the payment provider
3. Use test card numbers (e.g., Stripe's test card: 4242 4242 4242 4242)
4. Complete a test purchase to verify the entire flow works
5. Check that webhooks are received and processed correctly
6. Once testing is successful, switch to Live mode with production credentials

📦 Package & Pricing Management

Create subscription packages for both job seekers and employers. Define features, pricing, and duration for each plan.

Accessing Package Management

Navigate to Admin Panel → Packages from the sidebar menu.

Creating a New Package

Package Examples

Editing Packages

To modify an existing package:

1. Find the package in the list
2. Click the Edit (pencil) icon
3. Make your changes
4. Click "Update Package" to save

👥 User Management

Manage all users registered on your platform, including job seekers, employers, and administrators.

Accessing User Management

Navigate to Admin Panel → Users from the sidebar menu.

User Types

Managing Users

Viewing Users

The user list shows:

• User name and email
• User role (Seeker, Employer, Admin)
• Statistics (resumes created, jobs posted, etc.)
• Registration date

Searching Users

Use the search bar to find users by:

• Name
• Email address

User Actions

For each user, you can:

• 👁️ View: See user profile and details
• ✏️ Edit: Modify user information
• 🗑️ Delete: Remove user account (with confirmation)

💼 Job Management

Review and manage all job listings posted by employers on your platform.

Accessing Job Management

Navigate to Admin Panel → Jobs from the sidebar menu.

Job List Overview

The jobs page displays:

• Job Title: Position name and salary range
• Company: Employer who posted the job
• Location: Job location (city/remote)
• Type: Full-time, Part-time, Contract, etc.
• Posted Date: When the job was published

Job Actions

For each job listing, you can:

• 👁️ View: See full job details
• ✏️ Edit: Modify job information
• 🗑️ Delete: Remove the job posting

Moderation Tips

📝 Content Management

Customize the content displayed on various pages of your job portal, including the homepage, blog, and static pages.

Homepage Customization

Navigate to Admin Panel → Homepage to customize:

Hero Section

• Hero Slides: Create multiple slides with different headlines, descriptions, and images
• Statistics: Customize the stats displayed (e.g., "10K+ Active Jobs")
• Carousel Settings: Enable/disable auto-rotation and set interval

How It Works Section

• Add, edit, or remove steps that explain how your platform works
• Each step includes an icon, title, and description

Features Section

• Highlight key features of your platform
• Customize icons, titles, and descriptions

Call-to-Action (CTA)

• Customize the CTA banner title and button text
• Set the background color and link destination

Blog Management

Navigate to Admin Panel → Blog to manage blog content:

• Create and edit blog posts
• Set featured images
• Manage categories
• Schedule publication dates

Static Pages

Navigate to Admin Panel → Pages to manage pages like:

• About Us
• Privacy Policy
• Terms of Service
• Contact Information
• FAQ

📧 Email Configuration

Configure email settings to enable system notifications, password resets, and other email communications.

Accessing Email Settings

Navigate to Admin Panel → Settings → Email Settings.

SMTP Configuration

Enter the following SMTP details:

Popular Email Provider Settings

🤖 AI & Interview Setup

Configure OpenAI integration and AI-powered features including the video interview practice system.

Setting Up OpenAI

OpenAI powers multiple AI features in your platform including resume optimization, cover letter generation, job matching, and the AI interview practice system.

Getting Your OpenAI API Key

Configuring OpenAI in Your Platform

Add your OpenAI API key to your .env file:

# OpenAI Configuration
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

AI-Powered Features

Once OpenAI is configured, the following features become available:

AI Video Interview Practice

The AI Interview feature allows users to practice job interviews with an AI interviewer. It supports both text and video modes.

How It Works

1. User Starts a Session: Selects target job role, difficulty level, and interview format (text/video)
2. AI Generates Questions: Progressive questions from easy warm-up to challenging scenarios
3. User Answers: Via text or voice (in video mode)
4. AI Analyzes Responses: Provides feedback, scores, and improvement suggestions
5. Results Summary: Overall performance report with actionable insights

Interview Configuration Options

Question Types Generated

• Behavioral: "Tell me about a time when..." questions
• Technical: Role-specific skills and knowledge questions
• Situational: "What would you do if..." scenarios

Video Mode Features

• AI avatar that speaks questions using text-to-speech
• Voice recording for user answers
• Real-time transcription of responses
• Simulates real interview environment

Managing AI Costs

OpenAI charges per token (roughly 4 characters = 1 token). Monitor your usage:

Fallback Behavior

If OpenAI is not configured or unavailable:

• Interview questions fall back to a built-in question bank
• Resume features show helpful tips instead of AI suggestions
• No errors are shown to users - graceful degradation

Enabling/Disabling AI Features

Control AI feature availability in Admin Panel → Settings → Features Management:

• Toggle individual AI features on/off
• Useful for managing costs or during maintenance
• Changes take effect immediately

⚡ Feature Management

Control which features are available on your platform. Enable or disable features instantly without code changes.

Accessing Feature Controls

Navigate to Admin Panel → Settings → Features Management or click the link in the Settings sidebar.

Available Feature Toggles

You can control the following features:

AI Tools

• AI Resume Builder: AI-powered resume creation assistance
• AI Cover Letter: Automatic cover letter generation
• AI Job Matching: Smart job recommendations based on profile

Creation Tools

• Resume Builder: Visual resume builder
• Cover Letter Builder: Cover letter templates and editor
• Portfolio Builder: Portfolio page creation

How to Toggle Features

1. Find the feature you want to control
2. Click the toggle switch next to it
3. The change takes effect immediately

🔗 Third-Party Integrations

Connect external services to enhance your platform's functionality.

Accessing Integrations

Navigate to Admin Panel → Settings → Integrations.

Available Integrations

Google Analytics

Track website traffic and user behavior:

1. Toggle "Enable Google Analytics" to ON
2. Enter your Google Analytics tracking ID (e.g., G-XXXXXXXXXX)
3. Save changes

Slack Notifications

Receive alerts in your Slack workspace:

1. Toggle "Enable Slack Notifications" to ON
2. Configure your Slack webhook URL in the .env file
3. Save changes

Social Login

Allow users to sign in with social accounts:

• Google Login: Enable/disable Google OAuth
• Facebook Login: Enable/disable Facebook OAuth

Note: Social login credentials are configured in the server .env file, not the admin panel.

Cookie Consent Banner

Configure the GDPR-compliant cookie consent popup:

1. Go to Settings → Cookie Consent
2. Enable/disable the banner
3. Customize the message text
4. Set button labels (Accept, Reject, Manage)
5. Add link to your privacy policy

🛡️ Security & IP Blocking

Protect your platform from malicious users and bots by managing IP blocks and security settings.

Accessing IP Management

Navigate to Admin Panel → Settings → Security or Blocked IPs from the sidebar.

Viewing Blocked IPs

The blocked IPs list shows:

• IP Address: The blocked IP
• Reason: Why the IP was blocked
• Blocked At: When the block was applied
• Expires At: When the block will automatically lift (if not permanent)
• Status: Active or Expired

Blocking an IP Address

To manually block an IP:

1. Click "Block IP" button
2. Enter the IP address (e.g., 192.168.1.100)
3. Enter a reason for blocking
4. Choose duration:
   • Temporary: Set minutes/hours/days
   • Permanent: No expiration
5. Click "Block" to save

Unblocking an IP

To remove a block:

1. Find the IP in the blocked list
2. Click the Unblock or trash icon
3. Confirm the action

Automatic IP Blocking

The system automatically blocks IPs for:

• Too many failed login attempts
• Suspicious request patterns
• Rate limit violations

Automatic blocks expire after a set duration (configurable in settings).

Best Practices

• Monitor patterns: Watch for repeated attacks from similar IP ranges
• Use temporary blocks: Start with 24-hour blocks, escalate if needed
• Document reasons: Always add descriptive block reasons
• Review regularly: Check blocked IPs weekly, remove old entries

📋 Template Management

Manage resume templates, CV templates, and cover letter templates available on your platform.

Accessing Templates

Navigate to Admin Panel → Templates from the sidebar. You can also access specific template types:

• All Templates: Unified view of all template types
• CV Templates: Resume/CV specific templates
• Cover Letter Templates: Cover letter specific templates

Template Types

Managing Templates

Editing Template Details

1. Click the "Edit" button on any template
2. Update the Name and Description
3. Save changes

Setting Premium Status

Toggle the premium status to control whether a template is free or premium:

• Premium templates show a crown icon
• Free templates are accessible to all users

Template Categories

Templates can be organized by category:

• Professional: Corporate and business styles
• Creative: Design and artistic layouts
• Simple: Clean, minimalist designs
• Modern: Contemporary layouts

Filtering Templates

• By Category: Select a category from the dropdown
• By Access Type: Filter by free or premium
• By Search: Search by template name or description

📄 Resume Management

View and manage all resumes created by users on your platform.

Accessing Resume Management

Navigate to Admin Panel → Resumes from the sidebar.

Resume List View

The resume list shows:

• User: Name and email of the resume owner
• Resume Title: Title given by the user
• Template: Template used for the resume
• Created Date: When the resume was created

Managing Resumes

• View: Preview the resume content
• Delete: Remove inappropriate or requested deletions

Search & Filter

Use the search bar to find resumes by:

• User name
• Resume title

🔍 SEO Settings

Optimize your platform for search engines to increase visibility and traffic.

Accessing SEO Settings

Navigate to Admin Panel → SEO Settings from the sidebar.

General SEO

Social Media SEO

• OG Image: Image shown when your site is shared on social media (1200x630px recommended)
• Twitter Card: Type of Twitter card to use (summary, summary_large_image)

Advanced SEO

• Google Analytics ID: Your GA4 measurement ID (G-XXXXXXXXXX)
• Google Search Console: Verification code for Search Console
• Robots.txt: Custom robots.txt content to control search engine crawling

🏗️ Header & Footer Management

Customize your site's navigation menu, footer sections, and social links.

Accessing Header & Footer

Navigate to Admin Panel → Header & Footer from the sidebar.

Header Navigation

Managing Menu Items

1. Click "Add Menu Item"
2. Enter the Label (text shown in menu)
3. Enter the URL (link destination)
4. Set Target (_self for same tab, _blank for new tab)
5. Set Order (lower numbers appear first)
6. Toggle Active status

Creating Dropdown Menus

To create a dropdown:

1. Create a parent menu item with URL "#"
2. Create child items and select the parent in the Parent ID field

Footer Settings

Footer Logo & Copyright

• Upload a separate footer logo (can be different from header)
• Set copyright text (appears at bottom of footer)

Footer Sections

Create organized link sections in your footer:

1. Click "Add Section"
2. Enter section title (e.g., "Quick Links", "Resources")
3. Set order and active status
4. Add links to each section

Social Links

Add social media icons to your footer:

1. Click "Add Social Link"
2. Select the Platform (Facebook, Twitter, LinkedIn, Instagram, GitHub)
3. Enter your profile URL
4. Set order and active status

📜 Legal Pages Management

Create and manage legal pages like Privacy Policy, Terms of Service, and more.

Accessing Legal Pages

Navigate to Admin Panel → Pages from the sidebar.

Creating a Legal Page

1. Click "Create New Legal Page"
2. Enter the Title (e.g., "Privacy Policy")
3. The Slug is auto-generated (e.g., "privacy-policy")
4. Write your page content using the rich text editor
5. Toggle Published to make it live
6. Click Save

Common Legal Pages

• Privacy Policy: Required by law in most countries
• Terms of Service: User agreement for using your platform
• Cookie Policy: Details about cookie usage
• Refund Policy: Payment and refund terms

Publishing & Unpublishing

Click the toggle icon in the pages list to quickly publish or unpublish a page without editing it.

👨‍👩‍👧‍👦 Team & About Us

Manage your team members and About Us page content.

Accessing Team Management

Navigate to Admin Panel → Team from the sidebar.

Adding Team Members

1. Click "Add Team Member"
2. Enter Name and Position
3. Add a short Bio
4. Upload a Photo
5. Set Order for display sequence
6. Toggle Active status

About Us Page Sections

Customize different sections of your About Us page:

• Hero Section: Main headline and introduction
• Mission Statement: Your company's mission
• Vision Statement: Your company's vision
• Values: Core values with icons and descriptions

Editing Page Sections

1. Switch to the "Page Sections" tab
2. Click "Edit" on any section
3. Update title, subtitle, content, and image
4. For bullet point sections, add items to the List Items field
5. Save changes

📅 Company Timeline

Create a visual history of your company's milestones and achievements.

Accessing Timeline

Navigate to Admin Panel → Timeline from the sidebar.

Adding Timeline Events

1. Click "Add Timeline Item"
2. Enter the Year
3. Add a Title (e.g., "Company Founded")
4. Write a Description
5. Add Achievements (bullet points)
6. Select an Icon
7. Set order and active status

Timeline Display

Timeline items appear on your About Us page in chronological order, creating a visual journey of your company's growth.

🤝 Partnership Management

Manage partner logos, categories, and partnership requests.

Accessing Partners

Navigate to Admin Panel → Partners from the sidebar.

Partner Management Tabs

Partners Tab

Add companies and organizations that partner with your platform:

1. Click "Add Partner"
2. Enter company Name
3. Upload company Logo
4. Add Website URL
5. Select a Category
6. Set display order

Categories Tab

Organize partners by category:

• Create categories like "Technology Partners", "Recruitment Partners", etc.
• Partners are grouped by category on the public page

Partnership Requests

Review incoming partnership applications:

• View submitted requests from companies
• Approve or Reject requests
• Approved requests can be converted to partners

📬 Contact Messages

View and manage messages submitted through your contact form.

Accessing Contact Messages

Navigate to Admin Panel → Contact Messages from the sidebar.

Managing Messages

• Inbox View: See all messages with sender name, subject, and timestamp
• Read/Unread: Unread messages are highlighted; clicking marks them as read
• Message Details: Click any message to view full content
• Delete: Remove messages you no longer need

Responding to Messages

Messages include the sender's email address. Use your email client to reply directly to inquiries.

⚡ AI Usage Limits

Configure usage limits for AI features based on subscription packages.

Accessing AI Limits

Navigate to Admin Panel → AI Limits from the sidebar.

Understanding AI Tools

Setting Limits by Package

1. Click "Add New Limit"
2. Select the Package (Free, Basic, Premium, etc.)
3. Select the User Type (job_seeker or employer)
4. Choose the AI Tool
5. Set Daily Limit and Monthly Limit
6. Toggle Enabled status
7. Save

Example Limit Configuration

📈 AI Usage Analytics

Monitor AI feature usage across your platform.

Accessing AI Analytics

Navigate to Admin Panel → AI Analytics from the sidebar.

Available Metrics

• Total AI Requests: All-time usage count
• Job Seeker Requests: Usage by job seekers
• Employer Requests: Usage by employers
• Usage by Tool: Breakdown by AI feature
• Usage Trends: Charts showing usage over time

Using Analytics Data

Use this data to:

• Understand which AI features are most popular
• Plan OpenAI budget based on usage patterns
• Adjust package limits to match demand
• Identify potential abuse or unusual usage

📚 Additional Content Management

Manage FAQs, Help Center, Testimonials, Career Resources, and other supporting content.

FAQs Management

Navigate to Admin Panel → FAQs to manage frequently asked questions.

Adding FAQs

1. Click "Add FAQ"
2. Enter the Question
3. Enter the Answer
4. Select a Category (General, Account, Payments, etc.)
5. Set display Order
6. Toggle Active status

Help Center

Navigate to Admin Panel → Help Center to manage help documentation.

Three Components:

• Categories: Organize help articles by topic (Getting Started, Account, etc.)
• Articles: Create detailed help articles with tags
• Support Options: Configure contact methods (email, phone, chat)

Testimonials

Navigate to Admin Panel → Testimonials to manage user testimonials.

Managing Testimonials

• Approve/Reject: Review user-submitted testimonials
• Add Manually: Create testimonials for featured users
• Set Rating: 1-5 star ratings
• Add Photo: Upload testimonial author photos

Testimonial Types

• General: Overall platform feedback
• Job Seeker: Success stories from job seekers
• Employer: Feedback from hiring companies

Career Development Resources

Navigate to Admin Panel → Career Development to manage career resources.

Resource Categories

• Skill Building: Learning and development resources
• Interview Tips: Interview preparation guides
• Networking: Professional networking advice
• Job Search: Job hunting strategies

Resume Guide

Navigate to Admin Panel → Resume Guide to manage resume writing tips.

Section Categories

• Resume Tips: General resume advice
• Cover Letter Tips: Cover letter guidance
• Portfolio Tips: Portfolio building advice
• Interview Prep: Interview preparation content

Contact Information

Navigate to Admin Panel → Contact Info to manage your contact page entries.

Entry Types

• General: Main contact information
• Support: Customer support details
• Sales: Business inquiries
• Careers: Job opportunities at your company

Creating Entries

1. Click "Add Entry"
2. Enter Title (e.g., "Email Us")
3. Select Type and Icon
4. Add Description and Value (actual contact info)
5. Optional: Add CTA button with label and link

Companies

Navigate to Admin Panel → Companies to view and manage employer companies.

Company Types

Company Actions

• Search and filter companies
• View company details and job postings
• Delete inappropriate company profiles