# Getting Started
# What is it?
App Portal is an advanced app/software listing script with rich SEO features where you can create your own App Portal in minutes.
# Changelog
App Portal 2.1.0 Changelog
- Added: OpenAI Support
- Added: Amazon S3 Support
- Added: Wasabi S3 Support
- Added: Other Apps in the Category
- Added: Hreflang Support
- Added: RSS Category Support
- Added: Categories on Home Page
- Added: Bulk Delete Support
- Added: Versions on App Edit Pages
- Added: Error Pages Customization Support
- Added: Categories on Home Page
- Added: Custom Sitemaps
- Added: Top Bar
- Added: Package Name Field
- Improved: Localization System
- Improved: Slider Design
- Improved: SEO
- Deleted: Sitemap Ping Feature [Details]
- Fixed: Bugs
# Server Requirements
Before installing App Portal, please make sure your server meets the following requirements.
- PHP 8.0 or 8.1
- BCMath PHP Extension
- Ctype PHP Extension
- JSON PHP Extension
- Mbstring PHP Extension
- OpenSSL PHP Extension
- PDO PHP Extension
- Tokenizer PHP Extension
- XML PHP Extension
TIP
You can find many videos and tutorials on various topics in the members area of our site. Click here to access it.
# Installation
TIP
Simplified installation feature has been added with App Portal v2.1.0. If you have previously installed App Portal, we recommend that you review the steps again.
- Extract the .zip file downloaded.
- Upload all files to your server's home directory.
- Create a database and import database.sql
- Edit the .env file in the lapp folder in the FTP server and set the variables according to your URL, database and SMTP settings.
APP_URL=http://localhost
...
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=null
DB_USERNAME=null
DB_PASSWORD=null
...
MAIL_DRIVER=smtp
MAIL_HOST=mail.yoursite.com
MAIL_PORT=465
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=null
MAIL_FROM_NAME=null
Example Configuration
APP_URL=http://foxart.co
...
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE="app_portal"
DB_USERNAME="app_user"
DB_PASSWORD="Nc8^@59>1M"
...
MAIL_DRIVER=smtp
MAIL_HOST=mail.foxart.co
MAIL_PORT=465
MAIL_USERNAME="noreply@foxart.co"
MAIL_PASSWORD="oI58+8+2kj"
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS="noreply@foxart.co"
MAIL_FROM_NAME="Foxart Studios"
TIPS
- Variables must be written in double quotes. Example: "App Portal" instead of App Portal
- DB_HOST is usually 127.0.0.1 or localhost, but some servers may use different addresses.
- MAIL_ENCRYPTION is usually ssl or tls.
- If the SMTP settings are not valid, you will not be able to reset your password, in which case you will need to reset it with phpMyAdmin or a similar application. If you encounter such a problem, review the FAQ section.
- Change Chmod settings of the following folders to 755:
TIP
There is no need to change Chmod settings on most servers. We only recommend changing Chmod settings if you are getting file permission errors.
/lapp/storage/framework
/lapp/storage/logs
/lapp/bootstrap/cache
/images
and the folders under it.
/files
/screenshots
- That is all, Your site is ready! 🎉
# After Installation
Frontend: https://yoursite.com
Dashboard: https://yoursite.com/admin
Sitemaps: https://yoursite.com/sitemap.xml
The default admin credentials are:
- Email: admin@site.com
- Password: admin123456
Important
After the installation, please edit the robots.txt file in the home directory and replace https://yourwebsite.com/sitemap.xml with your own sitemap address
robots.txt
User-agent: *
Disallow:
Sitemap: https://yourwebsite.com/sitemap.xml
TIP
If you want to bulk delete demo apps on your newly created site, please run the link below after logging in to the dashboard:
https://yoursite.com/admin?delete_demo_data
# Security
# 1. Change the Admin Panel Login Address (Highly Recommended)
Change the following two lines in the .env file.
ADMIN_URL="admin"
ADMIN_LOGIN_URL="login"
Example Configuration
ADMIN_URL="admin_vN2gB49vg3"
ADMIN_LOGIN_URL="login_V2G0b3Flv"
After this, your admin panel login address will be as follows.
https://yoursite.com/admin_vN2gB49vg3
# 2. Change the Admin Panel Login Credentials (Highly Recommended)
After installation, log in to your panel and change your username and password by clicking Account Settings in the left menu.
# 3. Check .env File Accessibility (Highly Recommended)
The .env file contains a lot of sensitive information and should not be accessible with the browser, to test it, open the following address in the browser.
https://www.yoursite.com/lapp/.env
If you can access this file through the browser and view the variables in its content, create a file named .htaccess
under the /lapp folder and change its content as follows.
Deny from all
If you can still access the file, please contact your hosting company and request that it be resolved.
# 4. Making the /lapp Folder More Secure (Optional)
To make the lapp folder more secure, please move the /lapp folder to a higher directory and change the line below in the index.php file in the home directory.
$lapp_folder = '/lapp';
with
$lapp_folder = '../lapp';
Tips
- Please note that not all hosting companies may allow running the /lapp folder in the root directory. Some servers may not support this feature.
- You can change the name of the /lapp folder if you wish, in this case, be sure to change the name of the /lapp folder by editing index.php
# 5. Changing the APP_KEY (Optional)
The software comes with an APP_KEY, but we recommend that you update it for your security.
To create a new App Key, please visit https://yoursite.com/admin/random_key in your web browser to obtain an App Key and update the APP_KEY in the .env file.
TIP
Please note that you must be logged in to the admin panel to get a new App Key.
Assuming the system generates a new App Key for you as follows:
A58dx1XOI+b55P2psRFoq1ynqMr6N4CNt7j5ytwyQ8o=
Edit the relevant line in the .env file as follows:
APP_KEY=base64:A58dx1XOI+b55P2psRFoq1ynqMr6N4CNt7j5ytwyQ8o=
Note: You need to add the App Key after APP_KEY=base64:
❗️You can see an incorrect usage below.
APP_KEY=A58dx1XOI+b55P2psRFoq1ynqMr6N4CNt7j5ytwyQ8o=
Apps →