Environment Setup

  • Required PHP version 8.1
  • Enable this on your server before proceeding in PHP openssl, pdo, mbstring, tokenizer, JSON, CURL.
  • In Apache enable "mod_write" for guidance follow this click here
  • In Config enable "allow_url_fopen" for guidance follow this click here

Points to Remember

  1. Please be prepared with database name, database username name and database password.
  2. Create and set up an Onesignal account and update keys in admin settings.
  3. Create and set up email settings so your email can work.
  4. Setup a deep link setting so that your notifications will work properly.
  5. Translation using Chat GPT or Google Translation will work only after adding a keys make sure you have keys.
  6. Setup a deep link setting so that your notifications will work properly.
  7. Social media login for front end update keys in admin settings.
  8. Admob will work only when keys are added in admin settings.
  9. For facebook ads working have to add keys in admin settings.
  10. To approve comments automatically enable setting in the Global settings tab.

    11. Note : Above all setup is necessary if you won’t enable any of them that will cause not functioning properly.
  11. Upload the downloaded laravel code file from codecanyon.

Installation

  1. Login to your panel and search for "File Manager" and open it.
  2. Go to “public_html” and then click on “Upload” then upload the provided zip file on the server when the file is uploaded and extract that zip file there.
  3. Once previous steps are done open the domain URL in a new tab.
  4. On opening the site, you will get the setup wizard. Click "Check Requirements"
  5. On the Permission, click next step which is "Check Permissions"
    6. Note : If your folders don't have write permission go through all 3 sections. Change permission to 775 and reload this you can find all options to turn red to green and the button for proceeding to the next step will be visible.
  6. Click on "Form Wizard Setup".
  7. Fill your "App Name" which is a mandatory field this defines the name of your project.
    For "App URL" just copy the URL of your domain and paste it here.
    8. Note: Set the 'debug' to 'true' in the '.env' file to clearly display errors in the project. If 'debug' is set to 'false' and an error occurs, only a 500 error page will be shown. You can adjust this setting in the '.env' file at any time.

Database Configuration

  1. For the next step, configure the "database settings" on your CPanel. Follow the steps in my CPanel: Go to "MySQL Manager".
  2. Click on “Add Database”.
  3. Next,"add credentials" and "create a new user" for your database.
  4. Then provide all privileges and save these credentials.
    5. Note: Before saving, copy the database name, username, and password one by one. Save them into Notepad or keep a record, as we'll need these credentials for the next step. Without them, you won't be able to proceed.

Application Setup

  1. After creating the database credentials, use them in the next step. Put the credentials in the respective fields and click on 'Setup Application'.
  2. Click on 'Install'
  3. When the popup appears with 'Installation success' at the top, click on 'Click here to exit.' You will be redirected to the next step.
  4. In this step, enter the 'purchase code' received from CodeCanyon license. Put your purchase code and click on 'Verify'.
  5. When the verification is successfully done, you will be redirected to this page.
    From here, please copy and save the admin credentials so you can log in during the next step.
  6. Enter the email and password of the admin that you saved from the previous step.
  7. Once you have successfully logged in, everything is set up, and you are good to go. Congratulations! 🎉🥳

Rate Us Settings

  1. From the Sidebar, Open "Settings" section and then Click on "Translation Settings".
    2. You will find two fields for PlayStore Url ( Android ) and AppStore Url ( iOS ) respectively.
    You can change url from here to enable "Rate us".

Cron Job Settings

To schedule posts for automatic publishing, you need to create a cron job in hPanel. Follow these steps to set up a cron job :
  1. Access Advanced Options
    2. Log in to your hPanel account and navigate to the Advanced section for the particular domain you want to set up the cron job for.
  2. Access Cron Job Tab
    3. Click on the Cron Jobs tab within the Advanced section.
  3. Configure Cron Job
    • Choose the PHP option as the command type.
    • Enter your domain URL in the Command field.
    • Append the following command to the end of the URL :

      artisan schedule:run

    • The complete command should look like this :

      https://yourdomain.com/artisan schedule:run


  4. Auto publish Rss Feed Post
      5. Steps for Cron:-Select custom tab in cron jobs section and paste the below url of cron and set each hour in everyday timing.

      Cron job url :- wget -q -O /dev/null https://yourdomain.com/cron/rss

    1. First you need to go to Rss Feed section in the admin panel.
    2. In Rss Feed you need to enable auto published toggle and select the hour and no of post you want to publish automatically.

  5. Set Scheduler Run Time

      6. Choose how often you want the scheduler to run from the following options:

    • Every minute
    • Every hour
    • Every day
    • Every weekday
    • Every week

Basic App Setup

  1. Please refer to the flutter documentation before starting project setup
    2. You need to refer to the flutter Install Flutter
  2. Open Terminal
  3. To make sure your configurations are all set to run this project
    4. flutter doctor -v
  4. To make sure you are running the mentioned version given in the documentation
    5. flutter --version

    Flutter version : 3.5.0 <= 4.0.0 | Dart version : 3.2.3

    Please make sure you have Visual Studio Code DOWNLOAD VS Code

    Windows
      You should take these steps:
    1. Open RUN by shortcut (WINDOWS_KEY+R_KEY)
    2. Type in RUN SystemPropertiesAdvanced.
    3. System Properties dialog should appear, click Environment Variables.
    4. In User variables (The Top section) select Path and click Edit.
    5. Add the new path to flutter Binary folder like this C:\flutter\bin.
    6. Select OK, and OK again in Environment Variables, and OK in System Properties.
    7. Close any Command prompt you using and reboot the system.
    8. Now flutter is successfully installed.
    MACOS

    Please follow the steps below:

    1. Open the Terminal.
    2. Type: nano ~/.zshrc
    3. Type: export PATH=[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin:$PATH
    enter image description here
    1. Press control+x to Exit
    2. Type: source ~/.zshrc
    3. Restart the Terminal.
    4. Verify by typing flutter --version
    enter image description here

How to change app icon for iOS and Android ?

  1. Click on appicon.co to generate icons
    2. ( Note: Preferred image resolution to upload is 1024*1024 )
  2. After generating files, you can find these files :

  3. Open your project, and go to 'android/app/src/main/res/' file inside your project

  4. Replace below folders :
    5. For Android :
    • mipmap-hdpi
    • mipmap-mdpi
    • mipmap-xhdpi
    • mipmap-xxhdpi
    • mipmap-xxxhdpi
    For IOS :
    • Assets.xcassets
    How to change app icon within app ?
    In your project directoty, go to assets/img/ and replace all app icons to your desired icon. ( Note : Remember to keep the same name of image and resolution ).
      • appicon.png (512 × 512)
      • com_logo.png (600 × 600)
      • logo.png (408 × 115)

How to change Notification badge icon for android app ?

  1. Open your project, and go to android/app/src/main/res/ file inside your project
  2. Replace below folders :
    • To generate notification assets click given link : Generate Notification assets
    • android/app/src/main/res/drawable-mdpi/ic_stat_onesignal_default.png
    • android/app/src/main/res/drawable-hdpi/ic_stat_onesignal_default.png
    • android/app/src/main/res/drawable-xhdpi/ic_stat_onesignal_default.png
    • android/app/src/main/res/drawable-xxhdpi/ic_stat_onesignal_default.png
    • android/app/src/main/res/drawable-xxxhdpi/ic_onesignal_large_icon_default.png

Notification Icon for Firebase

  • Place this app icon with name "notification_icon" at "android/app/src/main/res/drawable/notification_icon.png"

How to change App Name & Bundle Id?

How to change App Name ?
  • In your project directory, go to "android/src/main/res/androidmanifest.xml".
    Find android:label="Incite" and replace Incite" to "{App-Name}"

How to change Bundle Id ?

  • Under Incite Project, Go to "android > app > build.gradle"
  • Under Incite Project, Go to "android > app > src > main > Kotlin > MainActivity.kt"

How to set Project URL ?

  • Replace "lib" folder with the newly updated code's "lib" folder
  • Navigate to "lib/urls/url.dart"and change values for "baseUrl = "https://your.server-url.com/api/" and "baseServer = "https://your.server-url.com/" to your server domain.

    • See attached screenshot below :

    Admin Settings to App (Both Android & iOS)

    • Change App Color
    • App under Maintenance
    • Add Live News & E-News on App Dashboard
    • Enable ADS
    • Change In-App Icon

    IOS setup for Incite

    Basic Setup

    1. Navigate to https://appleid.apple.com/sign-in and login to your apple account.
    2. In your Project folder, Open "ios" folder,
      Double-Tap on "Runner.xcworkspace" to open "Xcode"
    3. Click on "Team section", then Click +"Add an Account" and Login to your Apple account
    4. Setup provisioning profile on xcode
    5. Open Terminal and perform basic operations before going forward.
      Please use commands below :
      6. flutter clean
      and then run
      flutter pub get
      now run
      pod install

    How to change App Icon (IOS) ?

    Note : Before followiing this step, Please make sure you followed App Icon step.
    • Copy Assets.xcassets
    • Replace Assets.xcassets inside ios/Runner

    How to change Bundle Identifier and App Name ?

    1. Open Xcode, Under "General tab" Look for :
      • (a) Bundle Identifier field and replace it.
      • (b) In your project directory, go to "ios/runner/info.plist". Find "CFBundleDisplayName" & "CFBundleName", Replace Signal" to yourApp-Name

    Enabling Share Settings (iOS)

    1. Go to 'ios/Runner/info.plist'
    2. Change 'com.incite.app or (com.example.app)' given under 'CFBundleURLName' and change it as per your app in the given format 'com.example.app'. It is the host of your deep link.
    3. To enable Share link for iOS, Please make sure you have Enable Share blog on your Admin panel > Share Settings.In the Admin section, 'iOS Schema' to add ios://com.example.app, where 'ios' is the 'schema' and 'com.example.app' is your host
    1. To associate Deep link, Double Click to open "ios/Runner.xcworkspace", Your Xcode will be opened like the screen given in the screenshot.
      • Double Click on "Runner" given on the left side.
      • Click on "Signing Capabilities"
      • Replace with the domain (newblogit.fluttertop.com) url with your "Domain Url"
    2. Go to your cpanel and Open "File Manager" open path at "public_html/.well-known/apple-app-site-association". Add the given details accordingly as given in the screenshot.

      Please Add "Apple Team ID" and "Your iOS Bundle ID"

    Firebase Configuration (iOS)

    1. Open your firebase project and Click on "Project Settings"
    2. Scroll down and Click on Add App
    3. Then select platform for your app which is "iOS"
    4. Now, Enter your bundle ID ( Bundle Identifier ) and Click "Next"
    5. Download GoogleService-info.plist and replace in your "ios/Runner/GoogleService-info.plist", Click "Next"
    6. Click Next and proceed till Step 3 > Step 4 > Step 5 then Click on "Continue to Console"
    How to enable IOS Push Notifications (Flutter/Firebase) ?
    1. Push notification setup for iOS
    2. Refer to OneSignal iOS, then click on "Activate" iOS
      3. Note : When you follow link, Remember to :
      • Make sure you follow "OneSignal setup for incite"
      • Add p8 certificate (not p12 certificate) which you have generated from Apple developer account.
      • Follow this documentation for One Signal only.
    3. Get Team ID from iOS developers account
    4. Select iOS Sdk and proceed

    How to create build and release iOS App ?

    Follow this link : Build and release iOS App

    In App Force Update ( IOS )

    1. From the Sidebar, Open "All Settings" section and then Click on "Is IOS Force Update".
      2. You will find a toggle, when "enabled" it will let users force to update app if user is not updated to latest app version.
      If "disabled" then users can choose whether to use same app version or update to latest.

    Existing Project Changes

      Please remember while replacing this folder : If you have made customisations by yourself then we don't recommend this process.

        We have categorize changes in two variation :
      1. Minor updates
      2. Major updates

      Minor Updates

    • Replace "lib" folder with the newly updated code's "lib" folder
    • Navigate to "lib/urls/url.dart"and change values for "baseUrl = "https://your.server-url.com/api/" and "baseServer = "https://your.server-url.com/" to your server domain.

      • See attached screenshot below :

    • Go to main.dart, look for OneSignal.initialize("here add your onesignal app id") in the code at line 126. Add the notification that you have for your project
    • Replace "pubspec.yaml" file, before it please make sure you know the your app version. Please preserve it and after replacing pubspec.yaml file update the app-version (1.0.0+1) with your desired app version.

      • Major Changes (Rare Cases when major flutter version updated)

    • Before following major changes. Please follow the "Minor changes" given above
    • Replace "android/gradle/wrapper/gradle-wrapper.properties"
    • Replace "android/build.gradle"
    • Replace "android/app/build.gradle"
    • Replace "android/gradle.properties"
    • Replace "android/app/src/main/Androidmanifest.xml"
    • Place this app icon with name "notification_icon" at "android/app/src/main/res/drawable/notification_icon.png"

      • After replacing app/build.gradle file, do not forget to update the "bundle-id" of your project inside the file.

    • Replace "android/setting.gradle"
    • Place this file at "lib/enable_notification.dart"