Installing Admin Panel on Shared Hosting

1. Create your domain or subdomain in shared hosting.
2. Set up an empty database in your shared hosting and keep track of these credentials:
   i. Database name
   ii. Database username
   iii. Database password
3. Uploading the source code to Server
   i. Begin by extracting the Source Code you acquired from CodeCanyon.
   ii. Unpack the Admin Panel zip file and proceed to upload the PHP Code Folder's contents onto your Server.
   
   Note :- .htaccess file is essential; kindly verify its existence. If it is not visible, enable the option to display hidden files.
   Note :- Supported PHP versions are 7.4 to 8.1.
   
4. Now head to your project's URL (e.g., mydomain.com or subdomain.mydomain.com).
   The Installation screen will then walk you through the process seamlessly.

Great news! You're all set to start your Elite Quiz experience at: https://elitequiz.wrteam.me

Customize Admin Panel for your brand

• Change Login Page Background Image & Bot Image from here
• Add the JWT Key, which will be used to generate users token for added security.

Settings for the App

• Refer Coins : Amount of coins your referral gets for using your referral code.
• Earn Coins : Amount of coins user gets for referring.
• Reward Coins : Amount of coins user gets from watching Rewarded Ads.
• App Versions: Used for Enabling force update for users with outdated apps.
• Answer Display : Control whether to show users the correctness of their submitted answers.
• Language Mode : Control wether you want multilingual app or single language app.
• Option E Mode : Control wether you want 5 options questions or 4 options questions in quiz zone.
• Fix Question in Level : Choose between a fixed or varying number of questions for Levels.

In addition to that, you have full control over the types of quizzes you wish to display and those you prefer not to include.

Setup flutter

Explore the official Flutter website at https://docs.flutter.dev/get-started/install for a complete installation guide.
Prefer video tutorials? Check out the playlist:

Steps to run this project successfully:

1. Begin by extracting the downloaded code, resulting in the creation of the Elite Quiz - Flutter Code zip folder.
2. Next, extract the contents of the Elite Quiz - Flutter Code folder and launch it in either Android Studio or Visual Studio Code.
3. Access the IDE terminal and enter the command "flutter pub get" to fetch the necessary dependencies.
4. For iOS users, execute the following commands in the terminal:
   cd ios
pod install
cd ..
5. Finally, open the terminal and input "flutter run" to run the application. This will initiate the execution of the project.

Change app package name

1. If you are using Android Studio, you can press CTRL+SHIFT+R to open Replace in Files tool.
   then search our package name com.wrteam.flutterquiz and replace it with your package name in all places.
   

2. And if you are using VS Code, you can press CTRL+SHIFT+F to open Find in Files Tool.
   then search our package name com.wrteam.flutterquiz and replace it with your package name in all places.
   

Change application name

Similarly you can change the app name by finding and replacing in all the places.

Integrate firebase with your Project

1. First, Create a new Firebase Project
   
   
2. After creating your Firebase project, you'll now connect your Android application to it


3. Now, fill in the details, to get your SHA-1 & SHA-256 keys visit https://developers.google.com/android/guides/client-auth.
   SHA keys are required for using firebase authentication.
   
   
   
   
   


4. Now it's time for connecting IOS to your Firebase Project.

Congrats! You have successfully connected your android & IOS app to your firebase project.

Enable Firebase Authentication

1. Head to your Firebase project, click on the authentication menu, and enable all the mentioned sign-in methods from the image.

Note :- If your are using google sign-in you need to enable OAuth APIs that you want to use using https://console.developers.google.com/.
Enable people api and make sure you've filled out all required fields in the console for OAuth consent screen.
Otherwise, you may encounter APIException errors.

2. Add the SHA-256 key as shown in below image. Go to Project Settings -> Your apps -> Android apps
3. If you want to use Phone authentication in IOS then
   1. Go to ios/Runner/GoogleService-Info.plist and copy REVERSED_CLIENT_ID
   2. Paste it in ios/Runner/Info.plist as shown in below image

Enable Cloud Firestore

Cloud Firestore is required for Group & 1v1 Battles to work.
Follow these steps shown in images below.

Make Sure to add these rules in your firestore, otherwise it won't work.

Connect your admin panel to the app

1. Go to lib/utils/constants/constants.dart and add your admin panel url, like shown in the image below.

Enable Notifications for App

Access your Firebase project and locate "Project Settings" > "Cloud Messaging" as shown in the image.

Then, enable Cloud Messaging in Google Cloud.

Comeback to firebase project, copy the Server Key, and paste it under "Settings" > "Notification Settings"

Change application version and app launcher icon

Change App Logo

1. For Android, open android > app > src > main > res and add here your logo according to device screen size
2. For IOS open, ios > Runner > Assets.xcassets > AppIcon.appiconset here and add your logo according to diffrent size.

Set app's default language

1. The App's default language is English, but you can easily modify it. To do so, navigate to the lib/utils/constants/constants.dart file and locate the section displaying the language codes, as illustrated in the image below.
   You can obtain your desired language code from the following link: https://developers.google.com/admin-sdk/directory/v1/languages.
   Just ensure that the language code you select is available in the aforementioned link for proper functionality.
2. If your desired language code is not in supported languages list, add language code in list as shown in below image.
3. create a [language-code].json file in assets/languages/ if your desired language is not available. Copy all labels from en.json and translate the values accordingly.

Add new app language from admin panel

1. Enable language mode in your admin panel as shown in the image below
2. Go to languages section and select the language you want to from the drop down.
3. Also Add this language code in supported languages list in your app code.
4. create a [language-code].json file in assets/languages/ if your desired language is not available. Copy all labels from en.json and translate the values accordingly.

Change app colors

Configure Ads

Google AdMob

To begin, create an AdMob account and set up three Ad Units:

1. Banner Ad
2. Interstitial Ad
3. Rewarded Ad

1. For Android, go to android/app/src/main/AndroidManifest.xml and enter android App Id as shown in below image.
   
2. For IOS, go to ios/Runner/Info.plist and enter IOS App Id as shown in below image.
   
3. Go to Settings > Ads.Settings in admin panel and add AdMob ad ids as shown in below image.

Unity Ads

Change intro slider images

Update SVGs in assets/images folder using the same filenames shown in the images.

Change default profile avatar images

1. Update Avatars in assets/images/profile folder using the same filenames preferably shown in the images.
2. Then add those filenames in assets/files/defaultProfileImages.json file.

Configure In-App purchases

For android (Play Store)

• Upload your application to the Play Store and create in-app products as shown in the image. Ensure that the ID of consumable products in both Apple and Play Store is the same.
  

For IOS (App Store)

• Open the ios folder of the project into Xcode. Go to Capabilities. And enable "In-App Purchase" as shown in image.
• use the following links to get help enabling in-app purchases:
  https://help.apple.com/app-store-connect/#/devae49fb316
  https://help.apple.com/app-store-connect/#/devb57be10e7
  For further assistance, refer to the official Apple Developer documentation on in-app purchases at: https://developer.apple.com/in-app-purchase/

Add In-App products from Admin Panel

• Then After creating in-app purchase products, add their respective coins and productIds in Admin Panel > Settings > Coin Store Settings as shown in image.

Enable message feature in battles

1. Go to your firebase project, Firestore Database -> Indexes and create a composite query index as shown in below images.
   
2. Then from lib/utils/constants/constants.dart you can add/modify predefinedMessages a list of predefined messages as per your liking.
   
3. You can update the emojis from assets/images/emojis/. These emojis must be SVGs.
4. Any additional emojis that you might have added you also need to add them in assets/files/emojis.json

Configure force update

1. To do that go to admin panel, Settings -> System Configurations and enable force update.
   
2. Go to pubspec.yaml and copy the version number of application.
   
3. Enter the version number that we just copied into, Android and Ios Version fields.
   
4. Add the App Store & Play Store links to your app. And make sure that links are correct, otherwise force update will not work as expected.
   

Manage Badges

1. Manage badges from here
2. To unlock badges like Super Sonic, Flashback and Brainiac minimum question is set to 5.
   You can change that as shown in below image.
3. To unlock badges like Combat Winner, Clash Winner and Quiz Warrior winner must be declared by completing battle.
   
4. To get more information about how badges works click here.

Setup Exams

1. Go to admin panel, Settings -> System Configurations and enable exam module as shown in image.
   
2. If you want to update the exam rules you can do so by updating examRules in lib/utils/constants/constants.dart
   

Setup earning module

1. To set up the earning module for users to redeem coins, access the Admin Panel and go to Settings -> Payment Settings.
   Users can convert earned coins to real money with customizable conversion rates. For example here, per 10 Coins user will get 1 Amount.
   Amount here refers to the real money. And Currency Symbol will be used for the amount.
   
2. You can also modify the notes that will be shown to user when they redeem the coins, and for that go to lib/utils/constants/constants.dart
   
3. From there you also have the option to add or update payment methods.
   These methods require manual approval by the Admin, who then proceeds to send the actual funds to the users through their chosen payment options specified in this section.
   
4. Admin can view and process payment requests in the Payment Requests section of their Admin Panel.
   

Configure quiz timers, score and coins management

• Maximum Winning Coins : The highest coins users can earn based on their correct answers percentage in the quiz.
• Minimum Winning Percentage: The minimum correct answers percentage needed to earn Maximum Winning Coins.
• Score: Points awarded per correct answer.
• Timer Settings : Customize quiz durations from here.
• Welcome Bonus : coins received on initial login.
• Lifeline Deduct : adjust coins needed for using lifeline.
• Random Battle Entry : base entry fee for playing random battles.
• Review Answers Deduct : coins deducted for reviewing quiz answers.

Change app constants

1. In addition to modifying System Configurations and System Utilities, you have the option to make specific changes to certain application aspects through the lib/utils/constants/constants.dart file.
   
   These include altering Sound files, setting the initialSelectedCountryCode for the default country selection in the Phone login screen,
   defining maxPhoneNumberLength to limit the phone number length based on your country, adjusting the wait duration for opponents in battles, setting the in-between questions duration, modifying the deduction for wrong answers, and configuring extra points for the quickest answers, among other possibilities.
2. To modify coin distribution, access lib/utils/ui_utils.dart and update the equation according to your preferences.

Generate release version of this product