Alg2mer Shop Features
Authentications
After completing the installation process and initializing the database with the seeder, you can start using the system. To run the seeder, open https://your-domain.com/seeder.php in your web browser. This process will populate the database with the necessary data to operate the system and create a default user account. The default user credentials are as follows:
- Phone:
0123456789 - Password:
123456 - Role: This user has full administrative access and can perform any action within the system.
It is strongly recommended to use these credentials to log in and immediately either create a new administrative user, disable the default user, or change its password.
Important Note: Do not simply delete the default user account. If the seeder is run again, this account will be recreated. To prevent unauthorized access, either disable this account or change its password.
Roles Management
The role-based access control system within the application assigns specific roles to users, defining what actions they can perform. Each role encompasses a set of permissions, enabling users assigned to that role to execute specific tasks.
To manage roles:
- Log in with the default user credentials.
- In the navigation bar, select
Users & reports. - Click on
Rolesto view a list of all existing roles within the system.
From this interface, you can perform several actions:
- Create a New Role: Assign custom permissions to tailor the role according to your system's needs.
- Edit an Existing Role: Modify the permissions of a role to adjust its capabilities.
- Delete a Role: Remove a role from the system, provided no users are currently assigned to it. This ensures that you can maintain a clean and efficient role management structure.
The system's authorization is governed by a roles and permissions framework, which dictates what actions a logged-in user can perform based on their assigned permissions:
- View Permission: If a user has the view permission for a specific table, they can access the table's page to view the list of data.
- Create Permission: With create permission, a user can navigate to the create page to add a new record.
- Edit Permission: Users with edit permission can open the view page and modify data. If a user has view permission but not edit permission, they can only view the data without the ability to make changes.
- Delete Permission: If a user is granted delete permission, the option to delete records will be available on the list page, allowing them to remove records as needed.
This framework ensures that each user has access only to the functions that are necessary for their role, enhancing the system's security and operational efficiency.
Users Management
The system enables specific user management functionalities based on the permissions of the logged-in user. Users with "manage users" permissions can oversee other user accounts through the following steps:
- Access the users list by navigating to the navigation bar, clicking on
Users & reports, and then selectingUsers. - This action opens a table that lists user details including
Name,Role,Phone, andLast Logindate. - In this table, options to view, edit, or delete user accounts are available depending on the permissions granted.
This feature allows for efficient management of user accounts, ensuring only authorized users can perform administrative actions such as viewing, editing, or deleting user details.
Clients Management
The system facilitates comprehensive clients management for users with the appropriate permissions. Users granted "manage clients" permissions, encompassing create, update, view, and delete capabilities, can administer client accounts by following these steps:
- Navigate to the clients list by clicking on
Users & reportsin the navigation bar, then selectingClients. - This action displays a table listing client details such as
Name,Phone/Email,OTP,Login Type(options include phone, Google, Facebook, Apple, etc.),Code Version,Device Platform(Android, iOS), andLast Logindate. - Within this table, options to view or delete client accounts are available, facilitating the management of client information efficiently.
This system's design ensures that only authorized users can access and perform actions on client data, enhancing security and data integrity.
Alarm Contacts Management
The Alarm Contacts management feature enables administrators to curate a list of contacts designated to receive system-generated alarms. These notifications are crucial for immediate awareness and response to various system activities. Available alarms include notifications for:
- Receipt of a new order.
- A client message submitted through the "Contact Us" section.
- An item's quantity nearing depletion.
- Cancellation of an order.
Administrators have the flexibility to add an unlimited number of alarm contacts. Each contact can be individually enabled or disabled, allowing for precise control over who receives these critical notifications.
Reports
Beyond the dashboard, the system offers a variety of reports that provide insights into different aspects of operations. These reports include information on the most ordered items, categories with high demand, delivery areas with the most orders, and top ordering clients. Each report is designed to help administrators make informed decisions based on current trends and data.
Items Report
This report showcases the top 10 items that have been ordered the most within the system. It helps in identifying popular products.
Categories Report
Displays the categories containing the items that have been ordered the most. This report is useful for understanding which product categories are in high demand.
Clients Report
Highlights the top clients who place orders within the system. This information can be valuable for targeting marketing efforts and understanding customer preferences.
Delivery Areas Report
Shows the delivery areas with the highest number of orders. This report is essential for optimizing delivery routes and resources.
Categories
The system allows users to manage categories based on their permissions. Users with "manage categories" permissions can perform actions like creating, viewing, updating, and deleting categories. Here's how it works:
- Go to the navigation bar and click on
Categories & Items, then selectCategoriesto access the categories list. - You'll see a table displaying category details such as
Name,Root/Parent Category,Is Featured,Image, andCreation Date. - Depending on your permissions, you can view, edit, or delete categories directly from this table.
This feature streamlines category management, ensuring that only authorized users can handle administrative tasks related to categories.
Items
The system lets users manage items based on their permissions. Users with "manage items" permissions can create, view, update, and delete items. Here's how it works:
- Navigate to the navigation bar, click on
Categories & Items, then selectItemsto access the items list. - You'll find a table displaying items with columns like
Name,Seller,Supplier,Image,Quantity,Price,Categories,Is Featured,SKY Code, andCreation Date. - Depending on your permissions, you can view, edit, or delete items directly from this table.
This feature simplifies items management, ensuring that only authorized users can handle administrative tasks related to items.
Managing Properties
Manage your item properties such as Color, Size, and more, effortlessly within our system. The system empowers users to control properties based on their specific permissions. Only users granted with "Manage Properties" permissions are authorized to create, view, edit, or delete Properties. Follow these simple steps to manage properties:
- Access Properties: Go to the navigation bar, select
Categories & Items>Properties. This action opens the properties list. - View Properties: A table will display showing various property details including
Name,Type(e.g., Single Selection, Multi Selection),Is Enabled,Required,Searchable, andCreation Date. - Modify Properties: Depending on your assigned permissions, options to view, edit, or delete properties are available directly from the table.
This streamlined feature ensures property management is straightforward, allowing only authorized users to perform administrative tasks.
Managing Property Values
The system provides users with the flexibility to add and manage available values for any given property based on their permissions. Whether it's specifying available colors (e.g., red, green, blue, white, black) or defining sizes (S, M, L, XL, XXL, XXXL), managing property values is straightforward. Here's how you can manage them:
- Access Property Values: From the navigation bar, click on
Categories & Itemsand then selectProperty Values. This will take you to the list of all available property values. - View and Manage Values: A table will appear showing the property values with details such as
Namein both Arabic and English,Price(for payable properties),Property, andCreation Date. - Modify Values: Based on your permissions, you have the option to view, edit, or delete any property value directly from the table.
This functionality streamlines the management of property values, ensuring that administrative tasks are limited to authorized users, thus maintaining system integrity and customization capabilities.
Managing Statuses
The statuses feature is critical for managing the workflow and communication within the system. It allows you to customize how applications are tracked and communicated to clients, including changing the status name and the feedback message sent to clients. Here’s how to manage them effectively:
- Access Statuses: From the navigation bar, click on
Categories & Items>Statusesto open the list of all statuses. - View and Edit Statuses: A table presents the statuses with details such as
Name AR,Name EN,Status Key,Status Tag,Next Statuses, andCreation Date. - Customize Statuses: With the appropriate permissions, you can modify the name, feedback message, and define the sequence of next statuses directly within the table.
This functionality ensures streamlined status management, providing only authorized users with the capability to adjust workflow and client communications as needed.
Managing Suppliers
The Suppliers feature is designed to streamline the process of managing those who supply your market with items. It enables the addition of suppliers with details such as name, phone, and status. Here’s how you can manage them:
- Access Suppliers: From the navigation bar, click on
Categories & Items>Suppliersto view the list of suppliers. - Supplier Details: The table displays each supplier's details, including
Name,Phone,Is Enabled, andCreation Date. - Modify Suppliers: With the correct permissions, you have the capability to view, edit, or delete suppliers right from the table.
This functionality ensures efficient management of suppliers, granting access only to authorized users for performing these administrative tasks.
Managing Vehicles & Drivers
The Vehicles & Drivers section is crucial for businesses that rely on deliveries. It allows for the addition and management of drivers and their respective vehicles, ensuring smooth delivery operations. Here’s how to navigate and manage them:
- Access Vehicles or Drivers: Navigate to the navigation bar, click on
Categories & Items, and then chooseVehiclesorDriversto view the respective lists. - Viewing Vehicles: In the Vehicles section, you will see a table with
Name AR,Name EN,Is Enabled, andCreation Datecolumns. - Viewing Drivers: In the Drivers section, the table will show
Name,Phone,Vehicles,Color,Plate, andCreation Date. - Modifications: With the appropriate permissions, you are empowered to view, edit, or delete any entry in the Vehicles or Drivers tables directly.
This streamlined feature ensures that managing vehicles and drivers is efficient, allowing only authorized personnel to undertake related administrative tasks.
Managing Sellers
For ecommerce platforms with multiple sellers, the Sellers management feature is indispensable. It facilitates the creation, viewing, editing, and deletion of sellers, streamlining the process for those with the necessary permissions. Once sellers are registered in the system, their names can be associated with specific items, making the seller's information visible in the mobile application beneath the item name. Here’s how to manage sellers efficiently:
- Access Sellers: Go to the navigation bar, click on
General Settings, then chooseSellersto view the list of sellers. - Seller Information: The table lists sellers with details such as
Name AR,Name EN, andCreation Date. - Seller Management: With the appropriate permissions, you have the ability to view, edit, or delete sellers directly from the table.
This functionality ensures the efficient management of sellers, granting access only to authorized personnel for these administrative tasks.
Managing Multi Types for Pricing
The Multi Types feature allows for flexible pricing options by defining labels for different price points associated with an item. This is particularly useful for items that vary in price by size or quantity. For wholesale items, it enables setting prices based on quantity, such as by the dozen, half-dozen, or quarter-dozen. It's important to assign a Measure Unit to each multi type, indicating the quantity of items it represents—for instance, setting it to 12 for a dozen.
Here’s your guide to managing multi types effectively:
- Access Multi Types: In the navigation bar, click on
General Settings, then selectMulti Typesto view the list. - Multi Types Overview: A table will show multi types with details including
Name AR,Name EN,Measure Unit, andCreation Date. - Editing Multi Types: With the necessary permissions, you can alter the details of multi types or remove them altogether directly from the table.
This functionality streamlines the management of multi types, limiting administrative control to users with the appropriate permissions.
Managing Payment Methods
For an ecommerce platform, having versatile payment options is crucial for accommodating various customer preferences. The system supports three main types of payment methods, each customizable to suit your business needs. Whether enabling or disabling a method, the flexibility is in your hands:
- Access Payment Methods: Go to the navigation bar, select
General Settings, and thenPayment Methodsto reach the configuration page. - Configure Payment Methods: The page is divided into three tabs, each dedicated to a different payment method:
- Cash on Delivery (COD): Modify the label displayed to clients in the app and toggle the enable status.
- Offline Transfer: Set up details such as the label, card/account number, bank name, branch name, and the activation status.
- PayPal: Adjust settings including the label, PayPal mode (test or production), PayPal currency (ensure compatibility with PayPal's supported currencies), currency factor (for converting local currency to PayPal's), and the required credentials (Secret, Client ID).
- Modify Payment Methods: With the appropriate permissions, you can directly view and edit the payment methods to ensure they align with your operational and customer needs.
This functionality streamlines the management of payment methods, restricting administrative access to authorized personnel only, thus safeguarding the integrity of financial transactions.
Managing Coupons
Coupons are a powerful tool for incentivizing purchases and engaging customers in your ecommerce platform. With the right permissions, the Coupons section offers comprehensive management capabilities, allowing for the creation, modification, and monitoring of coupons. Coupons can be configured with various modes, including fixed amount discounts, percentage-based discounts, usage limits, specific expiration dates, and visibility controls. Here's a streamlined process for managing them:
- Access Coupons: Navigate to the navigation bar, select
General Settings, thenCouponsto open the list of available coupons. - Coupons Overview: The displayed table includes details such as
Name,Amount,Expire Date,Uses Count,Used Count,Is Visible, andCreation Date. - Coupon Management: With appropriate permissions, you can efficiently view, edit, or delete any coupon, tailoring the offer to meet your marketing strategies and customer needs.
This functionality ensures the easy management of coupons, restricting control to authorized personnel and thus maintaining the integrity of your promotional strategies.
Managing Vouchers & Voucher Groups
Vouchers and Voucher Groups offer a dynamic way to engage clients by generating random vouchers for discounts or promotions. This dual-section approach allows for bulk creation and management of vouchers, tailored to specific campaigns or customer groups. Here’s how to navigate these sections for effective management:
Voucher Groups
- Access Voucher Groups: Navigate to the navigation bar, click on
General Settings, then selectVouchers groupto view the list of Voucher Groups. - Voucher Groups Overview: The table will display Voucher Groups with details such as
Name,Vouchers Count, andCreation Date. - Manage Voucher Groups: With the necessary permissions, you can modify or remove Voucher Groups directly from the table, facilitating the organization of your voucher-based promotions.
Vouchers
- Access Vouchers: Go to the navigation bar, click on
General Settings, thenVouchersto see the list of Vouchers. - Vouchers Details: A table shows Vouchers with information including
Voucher Code,Group Name,Price,Price Type,Residual Price, andCreation Date. - Modify Vouchers: Authorized users can view, edit, or delete Vouchers, ensuring each voucher aligns with the intended discount strategy and remains valid for use.
This streamlined process enhances the management of Vouchers and Voucher Groups, providing control over promotional offerings and ensuring discounts are applied as intended, with oversight restricted to users holding the appropriate permissions.
Managing Delivery Areas
Delivery Areas functionality is essential for ecommerce platforms to specify where orders should be delivered. This feature offers great flexibility to accommodate different delivery logistics, whether it’s delivery points within the same city, various cities, or specific services like home delivery. Here’s how to effectively manage Delivery Areas:
- Access Delivery Areas: From the navigation bar, click on
General Settings, then chooseDelivery Areasto view the list of available delivery areas. - Overview of Delivery Areas: The table presents Delivery Areas with information including
Name,Working Days,Delivery Charges,Order Count(for prioritizing delivery areas),Delivery Before(indicating the cut-off time in hours for next-day delivery),Location(latitude and longitude for precise area definition),Clients(number of clients who have access to view orders in that area as managers),Is Enabled, andCreation Date. - Edit and Customize Delivery Areas: With the correct permissions, users can modify the details of Delivery Areas or remove them, tailoring the delivery service to meet both operational needs and customer expectations.
This streamlined process ensures efficient management of Delivery Areas, granting control to authorized personnel to oversee and adjust delivery capabilities as needed.
Managing Banners
Banners play a crucial role in enhancing the visual appeal and conveying key messages on the main page of the mobile application. With appropriate permissions, users can seamlessly manage the creation, display, and organization of banners, ensuring the mobile application remains engaging and up-to-date. Here’s a guide to managing banners effectively:
- Access Banners: From the navigation bar, select
General Settingsand thenBannersto view the list of current banners. - Banners Overview: The table showcases banners with details including titles and subtitles in both Arabic and English,
Image, activation status (Is Enabled),Order Count(which determines the banner's placement in the list), andCreation Date. - Banner Customization: Authorized users have the ability to view, update, or remove banners directly from the table, allowing for dynamic content management based on current promotions, events, or announcements.
This functionality streamlines the management of banners, granting control to authorized personnel to ensure the mobile application’s homepage remains visually appealing and informative.
Managing Client Messages
Client Messages is a crucial feature that captures feedback, inquiries, and complaints from customers via the contact us section of the mobile application. This section allows for direct communication with clients, enhancing customer service and engagement. Here's how to manage client messages effectively:
- Access Client Messages: Navigate to the navigation bar, click on
General Settings, then selectComplainsto view the list of client messages. - Overview of Client Messages: The table displays messages with essential details such as
Name,Phone,Message, andCreation Date. - Message Management: With the appropriate permissions, users can view or delete client messages from the table, ensuring timely and effective response to customer inquiries and feedback.
This functionality streamlines the management of client messages, enabling authorized personnel to efficiently address and manage customer communications.
Managing Orders
Orders are at the heart of any ecommerce system, offering a comprehensive overview of customer transactions. Accessing and managing orders is streamlined through the Orders section, where users are greeted with a dashboard displaying simple statistics about order statuses and the volume of orders within each category. Critical to this functionality is the ability to filter orders based on the creation date, status, or delivery area, with a default timeframe set to the last 30 days.
Key Features on the Orders Page:
- Order Details: The page lists all orders within the specified filter criteria, showing columns for the order ID, client name/image/phone, order number, payment method, total price, item count and quantities, order status (e.g., new, accepted, delivered, completed), payment status (paid, not paid), and order creation date.
- Bulk Actions: Users can perform bulk actions such as changing the status of all filtered orders to a specific status, exporting orders to an xlsx file, and filtering orders by status, delivery area, and date range.
- Order Viewing and Management: Selecting the view option on an order displays a detailed page with ordered items, refund options (if permitted), and actions like changing order status, printing the order, and copying order details to the clipboard. Client information and total order details are also provided, ensuring a comprehensive view of each transaction.
Order Status Modification:
- When opting to change an order's status, a new page with dropdown menus for status selection, driver assignment (if applicable), delivery area adjustments, and an option to add notes is presented. A checkbox to mark the order as paid or unpaid is also available, facilitating complete order management.
This structured approach ensures that managing orders is efficient, allowing only authorized users to conduct administrative tasks, thus maintaining the operational integrity and customer satisfaction levels of the ecommerce platform.
