README

This module provides professional service listing functionality for Magento 2, allowing customers to create and manage their professional profiles, which can be reviewed and approved by administrators.

Features

⚠️ ONLY HYVA Compatible! ⚠️
Customer professional profile management
Social media links integration
Certificates and services listing
Admin approval workflow
Profile status management (Pending, Approved, Rejected)
Ajax-based admin actions
Email notifications for status changes

Installation

Via Composer (Recommended)

Add the repository to your Magento 2 composer.json:

composer require qoliber/m2-professionals-service-listing

Enable the module:

bin/magento module:enable Qoliber_Psl
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation

Create the following directory in your Magento installation: app/code/Qoliber/Psl
Download the module and copy all files into the directory
Enable the module:

bin/magento module:enable Qoliber_Psl
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Configuration

Go to Stores > Configuration > Qoliber > Professional Service Listing
Configure the following sections:
- Social Media Platforms
- Available Certificates
- Services Offered by Agencty / Freelancer
- Email Notifications

Usage

Customer Side

Customers can create and manage their professional profiles from their account dashboard
They can add:
- Company information
- Profile picture/logo
- Social media links
- Certificates
- Services offered
- Description and contact details
- Set Their GEO Coordinates

Admin Side

Administrators can review profiles from Customer > Professional Service Profiles
For each profile, admins can:
- View all submitted information
- Approve profiles
- Reject profiles with a reason
- View profile status history

🔍 REST API: Profile Search

The module exposes a search API for frontend or integrations.

Endpoint:

Curl Example

curl -X POST "https://your-magento-site.com/rest/V1/psl/search" \
     -H "Content-Type: application/json" \
     -d '{
           "filters": {
             "country": "Poland",
             "city": "poznan",
             "certificates": [
               "Adobe Commerce Front-End Developer Expert",
               "Adobe Commerce Developer Professional"
             ],
             "services": [
               "Ecommerce Mobile App Development"
             ],
             "latitude": 52.4064,
             "longitude": 16.9252,
             "distance": "50km"
           }
         }'

Content-Type: application/json

{
    "filters": {
        "country": "Poland",
        "city": "poznan",
        "certificates": [
            "Adobe Commerce Front-End Developer Expert",
            "Adobe Commerce Developer Professional"
        ],
        "services": [
            "Ecommerce Mobile App Development"
        ],
        "latitude": 52.4064,
        "longitude": 16.9252,
        "distance": "50km"
    }
}

GEO Search

Fields:

latitude
longitude
distance

needs to be YOUR location

Support

For support and questions, please contact:

Email: extensions@qoliber.com
Website: https://qoliber.com

License

This module is licensed under the MIT License - see the LICENSE file for details.

Version

Current version: 1.0.0

Authors

Jakub Winkler (jwinkler@qoliber.com)

qoliber / m2-professionals-service-listing

Maintainers

Details