App Portal - Documentation

## Installation

Before you install App Portal make sure your server meets the following requirements.

## Server Requirements

- PHP >= 7.3
- BCMath PHP Extension
- Ctype PHP Extension
- JSON PHP Extension
- Mbstring PHP Extension
- OpenSSL PHP Extension
- PDO PHP Extension
- Tokenizer PHP Extension
- XML PHP Extension

## Installing App Portal

- 1. Extract .zip file downloaded from CodeCanyon. After extraction you will see 4 folders, "lapp", "public", update and "documentation".
- 2. Connect to your FTP account and upload folder named "lapp" to your root directory (please do not upload to public folder).
- 3. Go to public folder on your computer and upload all files to your public folder (e.g. httpdocs, public_html, www).
- 4. Create a database and import database.sql file to your new database.
- 5. Edit .env file in root folder of your FTP account and set variables according to your database and SMTP settings.
- 6. Change Chmod settings of the following folders to 755:

lapp/storage/framework

lapp/storage/logs

lapp/bootstrap/cache

public/files

public/images

public/images/news

public/images/sliders

public/images/submissions

public/images/topics

public/images/temp

- 7. This is all, Your site is ready!

If you are having trouble, please review the Problems & Solutions section in this document.

## After Installation

- Frontend URL: http://yoursite.com
- Admin Panel URL: http://yoursite.com/admin
- Sitemap URL: http://yoursite.com/sitemap.xml

Default admin username and password are as follows:

- Username: site@admin.com
- Password: admin123456

Note: Please don't forget to change your username and password for your security.

## Security

APP_KEY

##### Your software will come with a APP_KEY, but for your security please update it.

You can generate a key by the following command:

    php artisan key:generate

If you have SSH access to the administrative shell, please visit http://yoursite.com/admin/random_key to get a KEY and update APP_KEY in your .env file.*

*Please note that you must be logged into your admin panel to get APP_KEY.

## Apps

- Title: Name of the application.
- Description: Description of the application.
- Tags: Tags of the application. Use comma to create a new tag.
- Category: Category of the application.
- Platform: Platform of the application.
- Button Title: Title of button.
- Developer: Developer of the application.
- Download/Page URL: File URL or link.
- Download/Visit Counter: Total number of clicks on the link.
- License: License information (e.g. Free or $0.99) - this information also affects structured markup data in your HTML codes, which is very important for SEO (Optional).

Example HTML Code (Free Application):

    "offers":{"@type":"Offer","price":"0","priceCurrency":"USD"}

Another Example (Application Price is $0.99):

    "offers":{"@type":"Offer","price":"0.99","priceCurrency":"USD"}

- File Size: File size of the application (Optional).
- Image: Image of the Application, if image not uploaded, default app image will be displayed (Optional)
- Detailed Description: Detailed information of application (Optional).

Example Google Search result:

#### Q&A

Where can i add screenshots?

You can add screenshots in the screenshots section of application editing page.

### Screenshots

Applications Page

Create Application

## Categories

- Category Title: Name of the category.
- Category Icon: Icon of the category, an icon will be displayed next to category name in the navbar (Optional).
- Schema.org applicationCategory: The type of application, you can use this property for your content to be eligible for display as a rich result. You can find a link to "Supported App Types" in the end of this document (Optional but highly recommended).

Example HTML Code:

    "applicationCategory":"https:\/\/schema.org\/FinanceApplication"

- Show in Navbar: If selected, category name will appear in the navbar (Optional).
- Show in Footer: If selected, category name will appear in the footer (Optional).

Note: You can easily change order of categories by dragging and dropping in the list of categories.

#### Video

Adding category

#### Video

Changing category order

### Screenshots

Categories Page

Create Category

## Platforms

- Platform Title: Name of the platform (e.g. Android, Windows).
- Platform Icon: Icon of them platform, an icon will be displayed under the application information in application listing pages.

Note: You can easily change order of platforms by dragging and dropping in the list of platforms.

#### Video

Adding platform

#### Video

Changing platform order

### Screenshots

Platforms Page

Create Platform

## Pages

You can create as many custom page as you want like "About Us", "Privacy Policy" etc., they will be displayed in the footer.

- Page Title: Title of the page.
- Page Description: Content of the page.

Note: You can easily change order of pages by dragging and dropping in the list of pages.

#### Video

Adding custom page

#### Video

Changing page order

### Screenshots

Pages Page

Create Page

## Sliders

- Title: Title of the Slider.
- Application Name: Application name that will be redirected when users click Slider image.
- Image: Image of the Slider.
- Active: Select active status if you want this Slider to be visible.

Sliders Page

Create Slider

## Topics

- Title: Title of the Topic.
- Application Name: Description of the Topic.
- Image: Image of the Topic.

Topics Page

Create Topic

List of Topic Items

## News

- Page Title: Title of the News.
- Short Description: Short description of the News.
- Article: Full text of the News.
- Image: Image of the News.

News Page

Create News

## Content Manager

You can easily add applications from Google Play Store, search some term and results will be listed below the search box, just click submit button next to the application you want to add, on the next page system will retrieve application details.

Some Hints

- 1. If you want to check details of application in Google Play Store, just click the name or image of application, you will be redirected to application page in Google Play Store.
- 2. If the application was previously added, you will see status Added, if you click this button you will be redirected to application page in your website.

Important Note

Before using Content Mananger please go to Category Settings and select related categories. System will automatically select related categories in auto submission and manual adding mode. If your website doesn't cover all categories in Google Play store, please create a category (like Other) and select this category to submit all other applications to this category.

#### Video

Adding application with Content Manager

#### Screenshots

Content Manager Search Page

Create Application with Content Manager

Content Manager Category Settings

## Ads

Here you can add HTML ads from services like Google Adsense and Amazon Associates Program.

- Ad Location: Location of the ad spot.
- Status: Status of the ad spot.

#### Video

Adding HTML Ads

### Screenshots

Ads Page

## Comments

- Title: Title of the comment.
- Name: Name of the person who added the comment.
- E-mail: E-mail address of the person who added the comment.
- Rating: Rating that given by commenter.
- Details: Time and IP details.

#### Q&A

How to approve a comment?

To approve a comment, click the Pending button, then in the popup window, review comment and click Approve or Cancel button.

How to un-approve a comment?

To un-approve a comment, click the Approved button, then in the popup window, click Mark as unapproved button.

### Screenshots

Comments Page

## Translations

- Language: Name of the language.
- Language Code: 2-letter code of the language, for example for the German language: de. You can find a link to "ISO 3166-1 alpha-2 Country Codes" in the end of this document.
- OG:locale Tag: OG:locale code of the language. You can find a link to "List of Country Locale Codes" in the end of this document.

### Screenshots

Translations Page

Create Translation

## Submissions

Here you can approve or deny applications that submitted by visitors.

- Title: Title of the application.
- Name: Name of the person who added the application.
- E-mail: E-mail address of the person who added the application.
- Details: Time and IP details.

### Screenshots

Submissions Page

## Permalinks

Here you can change the permalink structure of your site.

### Screenshots

Permalinks Page

## Site Settings

- Site Title: Title of your site, it will appear in the title bar of the users browser, also show up as the title displayed in search results.
- Site Description: Description of your site, it will be displayed in the footer, also show up as the description displayed in search results (except of application pages).
- Site Logo: Logo of your site. A transparent image in PNG format is recommended.
- Favicon Favcion of your site. It will be displayed next to the website URL in the address bar. An image in PNG format with a size of 192x192 is recommended.
- Site Language: Language of your site. Please note that both frontend and admin panel languages will be changed.
- Navbar Color: Color of the navbar.
- Crontab Link (Auto Submission) To add new applications automatically from Google Play Store, run Crontab Link periodically (1-2 times per hour recommended). Please note that sending too many requests to Google Play Store, may lead to ban your IP address.
- Auto Content Submission from Google Play Store Here you can enable and disable auto application submission from Google Play Store.
- Facebook Page URL: Facebook page URL of your website. It will be displayed in the navbar and footer. If you don't have a facebook page please leave it blank, icon will not be displayed.
- Screenshots to be downloaded Number of screenshots to be downloaded in auto submission mode, to disable download screenshots set it to 0.
- Twitter Account Username: Twitter username of your website. It will be displayed in navbar and footer. If you don't have Twitter account please leave it blank, icon will not be displayed. Please make sure that you fill only account username, not URL.
- Show Random App Link in the Navbar: If selected, a link with icon will be displayed in the navbar, which randomly redirects users to application pages.
- Time before download/redirect (in seconds): Number of seconds to wait before the download or redirection begins automatically.
- Default App Image: If you do not upload a picture, this image will be displayed as application image, image size is 200x200.
- Default Share Image: This image will be displayed in social media sites when you share pages other than application pages, image size is 600x315.
- HTML Code - Before </head> Tag: You can add any HTML code before </head> tag, a great place to add tracking codes like Google Analytics.
- HTML Code - After <body> Tag: You can add any HTML code after <body> tag.
- HTML Code - Before </body> Tag: You can add any HTML code before </body> tag.
- Crontab Link (System): To clear system query cache (which speeds up your site) and vote records (which prevents multiple votes), run Crontab Link periodically (1-2 times per day recommended), for the system consistency please don't share this unique link with others and note that the old link will be disabled when you create a new link.
- Crontab Link (Hourly): To keep "Popular Apps In Last 24 Hours" section up to date, run this Crontab Link every hour.
- Google Play Country: Code of preferred country of Google Play Store, for example if you select DE (Germany) content manager will search applications (if available) from Google Play Store Germany, you can find a link to "Google Play Store Supported Languages" in the end of this document.
- Google Play Language: Code of preferred language of Google Play Store. For example if you select de (German Language) content manager will search applications in German Language. Please note that not all applications are translated to local languages by application publishers. You can find a link to "ISO 3166-1 alpha-2 Country Codes" in the end of this document.
- Schema.org Price Currency: Currency of paid applications listed on the site, for example for Swedish Krona please use SEK, this information also affects structured markup data in your HTML codes, you can find a link to "ISO 4217 Currency Codes" in the end of this document.
- Show Cookie Notification Bar: If selected, a cookie notification bar (A.K.A. EU Cookie Law (GDPR)) will be shown to visitors.
- Enable App Submission Form: If selected, a link to application submission form will be displayed in the footer.
- Show RSS Feed Link in the Navbar: If selected, a link with icon will be displayed in the navbar.
- Enable Breadcrumbs: If selected, the breadcrumbs bar will be displayed on top of the pages.
- Ping Google When Sitemap Updates: If selected, the system will ping Google when the sitemap is updated.
- Enable System Cache: If selected, mySQL queries will be cached.
- Approve Comments Automatically: If selected, all comments will be approved automatically.
- The Site Runs on Cloudflare: If your site is using Cloudflare, you will need to choose this. Otherwise, users will vote with the IP addresses of Cloudflare, or when they submit a comment or App, you will not be to see their real IP address.
- Schema.org Markup for Breadcrumbs: Google Search uses breadcrumb markup in the body of a web page to categorize the information from the page in search results. (Optional but highly recommended).
- Show Estimated Reading Time on News Pages: If selected, visitors will see the estimated reading time of the News on the News detail pages.

### Screenshots

Settings Page

## Useful Links

Settings Description

- App Portal Video Tutorials (Youtube)
- About Schema.org (Wikipedia)
- About Cron (Wikipedia)
- Structured data "Software App" Reference Page (Google Developers)
- Google Play Store Supported Languages (Google Play Console)
- ISO 3166-1 alpha-2 Country Codes (Wikipedia)
- ISO 4217 Currency Codes (Wikipedia)
- List of Country Locale Codes
- Supported App Types. (Google Developers)

## Problems & Solutions

1. I am getting blank page after installation.

First of all please check the webserver error_log file. This can give you an idea of the problem. Some servers do not allow uploading files to the root folder. In this case, you may need to run lapp in the public folder. After uploading lapp folder to the public folder, edit index.php, and change the following line.

change

    $lapp_folder = '../lapp';

to

    $lapp_folder = '/lapp';

In this scenario, the public folder will look like the following.

If you still cannot solve the problem, please contact us.

2. I can't log in to my dashboard.

To reset your password please click "i forgot my password" link on the login page, you will receive an email about resetting your password.

Please make sure that you filled mail server information in the .env file, otherwise, you cannot receive the email. If you didn't do this before, please edit the .env file in the lapp folder and change the following lines.

MAIL_DRIVER=smtp

MAIL_HOST=smtp.mailtrap.io

MAIL_PORT=2525

MAIL_USERNAME=null

MAIL_PASSWORD=null

MAIL_ENCRYPTION=null

MAIL_FROM_ADDRESS=null

MAIL_FROM_NAME=null

MAIL_ENCRYPTION (ssl or tls)

If you don't know mail server details, please contact your hosting company to get help from them.

Also, you can change your password with phpMyAdmin, just edit the users table and update the password of the administrator. You can generate a password on this page