WebApp setup notes

Posted on August 27, 2024 by hadmin
  1. The Guide describes the entire CJ WebApp at a high level, and how the different parts link together.  Therefore, it is very important!
  2. The Club Jubilee webapp is at https://webapp.clubjubilee.com/
  3. The site is built on the Laravel php platform, which is a well known and popular web framework.
  4. The database is MySQL, which is a well known and popular database for websites and web applications.
  5. There are integrations from the ‘core’ Laravel system to 6 other systems:
    1. The Club Jubilee website (parents complete a Club Jubilee website enquiry form, which will create a draft User on the CJ WebApp system, which can then be accepted by the Admins when logged into the system).
    2. CYTA Telecom SMS services (for sending messages out to parents).
    3. Google Cloud Analytics (Google Spreadsheets used for reporting purposes).
    4. The JCC Payment Gateway (for parents to make payments)
    5. Gitlab (application repository and version management). This is where the source code for the application is kept and managed.  Details are below.
    6. The Club Jubilee email system for automatic payment acknowledgement.  Note, this is no longer in use since the new version of the JCC Payment Gateway automatically sends a confirmation email to the parent when they pay.
  6. Each of these integrations is discussed in more detail a bit later below.
  7. Administrative User access to the core CJ WebApp is via https://webapp.clubjubilee.com/admin/login.  This is the LIVE system. You can also login to the TEST system at https://test.clubjubilee.com/admin/login
  8. The WordPress administrator login is ‘admin@clubjubilee.com’.
  9. The password is held by the Jubilee office.
  10. Once logged in, the administration of Administrative users is done via https://webapp.clubjubilee.com/admin/myaccount.  Here Administrative Users can  be defined and passwords can be reset for existing Admin Users.  Admin Users can also be deleted from here.
  11. Git is used to manage the application source code.  The master repository is on the cloud based ‘Gitlab’ service at https://gitlab.com/aleksandar.milenkovic.pk/hoteliqa
  12. The repository can be cloned via ssh: git@gitlab.com:aleksandar.milenkovic.pk/hoteliqa.git. The ssh password is 6#i=y~EZIYWq.
  13. After cloning the code, the following commands should be run in the terminal:
    1. php artisan view:clear,
      then php artisan config:clear,
      then php artisan cache:clear
  14. If the code pull has been made to a test environment, the following files need editing:
    1. app/lib/jcc/jcc.php needs the merchant ID, password and JCC test URL updated to point to test, as per below
      public $password = ‘862u1Xxv’; //TEST
      public $merchantID = ‘0095521019’; //TEST
  15. For the test environment, for setting all SMS records to go to a single phone number, change edit the file app/lib/jcc/jcc.php to make all SMS go to a single test phone edit config/globals.php and change the final return – add json element “testPhone” => “35796922621”
  16. Google Analytics sites are as follows:
    1. LIVE on the Hoteliqa Google ID…
      https://docs.google.com/spreadsheets/d/1Z-zh4D10ghuI9BrOOSd7pJUtHx_vMMR_WMSRFAXNMO8/edit#gid=0
    2. Test on the Hoteliqa Google ID…
      https://docs.google.com/spreadsheets/d/1_y_O9jJnG5VO9cjGWNonZX800IYHcEg106W5nSDNmpA/edit#gid=0
  17. If a parent makes a web form enquiry from the Club Jubilee website, the process of sending the enquiry data to the WebApp is via a WordPress function/hook defined in the theme’s ‘functions.php’ file.
  18. The system is integrated via API to the JCC payments system for taking payments from parents.  See file app/lib/jcc/jcc.php and other files in the same directory.
  19. The file controlling JCC is app/Lib/jcc/jcc.php and will need changing for test/live as appropriate. See the file for details.
  20. app/Http/controllers/JCCController.php will need changing for test/live as appropriate. See the comments within these files for what needs changing for TEST. There are also OLD JCC files in these directories for the original JCC API version 10.5 which we used in 2021.
  21. The JCC login credentials are:
  22. The domain registration is administered by the Jubilee office (networksolutions.com).  Hoteliqa does not have access to the domain Administration service.
  23. The domain servers and DNS records are with Krystal hosting (see hosting doc).  The DNS servers are NS1.KRYSTAL.UK and NS2.KRYSTAL.UK
  24. The email server (for @clubjubilee.com) is administered by the Jubilee office, with the DNS MX record pointing to the 3rd party email service.
This entry was posted in ALL, CJ WebApp, CJ Website. Bookmark the permalink.

Leave a Reply

Your email address will not be published. Required fields are marked *