📄 Documentation: ComingSoon1.cshtml


📑 Table of Contents

  1. Overview & Purpose
  2. Layout Definition & ViewBag
  3. HTML Structure & Key Functional Areas
  4. Dependencies & Technologies
  5. View Models & Data Models
  6. Helper Methods & Utilities
  7. Third‑party Integrations
  8. Error Handling & Return Types
  9. API Endpoints Overview
  10. UML Diagram
  11. Usage Examples
  12. Conclusion

1. Overview & Purpose

🚧 ComingSoon1.cshtml is an ASP.NET MVC Razor View located in Views/Home/.
Its primary role is to present a “Coming Soon” / “Under Construction” landing page with:

  • A friendly message
  • An illustrative SVG
  • A live countdown timer
  • Minimal navigation (home button is commented out)

This page is ideal for features or entire sites still in development.


2. Layout Definition & ViewBag

@{
    ViewBag.Title = "Coming Soon";
    Layout = "~/Views/Shared/_ATSLayout.cshtml";
}
  • ViewBag.Title
    Sets the browser tab title to “Coming Soon”.

  • Layout
    Inherits the shared layout _ATSLayout.cshtml which provides site-wide header, footer, styles, and navigation.


3. HTML Structure & Key Functional Areas

<div class="row">
  <div class="text-center">
    <!-- Illustration -->
    <div class="row justify-content-center mt-5">
      <div class="col-sm-3">
        <div class="maintenance-img">
          <img src="~/images/coming-soon.svg" alt="" class="img-fluid mx-auto d-block">
        </div>
      </div>
    </div>

    <!-- Message -->
    <h4 class="mt-2">THIS WEBPAGE IS UNDER CONSTRUCTION</h4>
    <p class="text-muted">Please check back soon</p>

    <!-- Countdown -->
    <div class="row justify-content-center mt-2">
      <div class="col-md-8">
        <div data-countdown="2022/05/31" class="counter-number"></div>
      </div>
    </div>
  </div>
</div>

3.1 Header Section

  • Commented Home Button
    @* 
    <div class="home-btn d-none d-sm-block">
      <a [email protected]("Index", "Home") class="text-white">
        <i class="fas fa-home h2"></i>
      </a>
    </div>
    *@
    
    – Currently disabled; can be toggled on to allow returning to the home page.

3.2 Maintenance Image 🖼️

  • Renders ~/images/coming-soon.svg centrally with Bootstrap’s responsive classes.
  • Encourages engagement with a graphic representation of “maintenance”.

3.3 Countdown Timer ⏳

  • Uses a div with data-countdown attribute (format: YYYY/MM/DD).
  • Class: counter-number
  • Initialized via the jQuery Countdown plugin in coming-soon.init.js.
<!-- Core JS -->
<script src="~/libs/jquery/jquery.min.js"></script>
<script src="~/libs/bootstrap/js/bootstrap.bundle.min.js"></script>
<script src="~/libs/metismenu/metisMenu.min.js"></script>
<script src="~/libs/simplebar/simplebar.min.js"></script>
<script src="~/libs/node-waves/waves.min.js"></script>

<!-- Plugins -->
<script src="~/libs/jquery-countdown/jquery.countdown.min.js"></script>

<!-- Page Init & App JS -->
<script src="~/js/pages/coming-soon.init.js"></script>
<script src="~/js/app.js"></script>
File Purpose
jquery.min.js DOM manipulation
bootstrap.bundle.min.js Layout & components
metisMenu.min.js Multi-level sidebar menu
simplebar.min.js Custom scrollbars
waves.min.js Ripple effect on click
jquery.countdown.min.js Countdown timer plugin
coming-soon.init.js Initializes the countdown on page
app.js Global JS handlers & site scripts

4. Dependencies & Technologies 📦

  • ASP.NET MVC (Razor engine)
  • Bootstrap 4/5 for responsive layout
  • jQuery + Plugins:
    • metisMenu
    • simplebar
    • node-waves
    • jquery-countdown
  • Font Awesome for icons (home icon commented)

5. View Models & Data Models

None. This View does not expect a strongly‑typed model.
It relies entirely on static markup and JavaScript.


6. Helper Methods & Utilities

  • Url.Action (commented)
  • data-countdown attribute: processed by coming-soon.init.js:
// coming-soon.init.js (excerpt)
$('[data-countdown]').each(function() {
  var $this = $(this), finalDate = $(this).data('countdown');
  $this.countdown(finalDate, function(event) {
    $this.html(event.strftime(
      '<span>%D <small>Days</small></span> ' +
      '<span>%H <small>Hours</small></span> ' +
      '<span>%M <small>Minutes</small></span> ' +
      '<span>%S <small>Seconds</small></span>'
    ));
  });
});

7. Third‑party Integrations 🔗

  1. jQuery Countdown – Provides date calculation & live timer UI.
  2. Bootstrap – Layout grid & utility CSS.
  3. MetisMenu & Simplebar – Enhanced navigation & scrollbar.
  4. Node‑Waves – Click ripple effect (visual polish).

8. Error Handling & Return Types

  • No server‑side error handling in this view.
  • Client‑side errors (e.g., countdown plugin failures) will be silent—failing to render the timer if the plugin is missing or data-countdown is invalid.

9. API Endpoints Overview

None – This is a purely static front-end page.
If integrated later, you may wire up an API to fetch the “launch date” dynamically.


10. UML Diagram

+--------------------------------+
|        _ATSLayout.cshtml       |
|  (Shared Layout: Header/Footer)|
+--------------+-----------------+
               |
               v
+--------------------------------+
| ComingSoon1.cshtml (View)      |
|--------------------------------|
| - ViewBag.Title = "Coming Soon"|
| - Image: coming-soon.svg       |
| - Countdown (data-countdown)   |
+--------------------------------+
               |
               v
+--------------------------------+
| coming-soon.init.js (Script)   |
| - Reads data-countdown attr    |
| - Calls jQuery.countdown()     |
+--------------------------------+

11. Usage Examples

  1. Change Launch Date
    <div data-countdown="2023/12/25" class="counter-number"></div>
    
  2. Re-enable Home Button
    <div class="home-btn d-none d-sm-block">
      <a href="@Url.Action("Index","Home")" class="text-white">
        <i class="fas fa-home h2"></i>
      </a>
    </div>
    
  3. Custom Styling
    Override .maintenance-img img in your SASS/CSS to adjust size or add animations.

12. Conclusion 🎉

ComingSoon1.cshtml delivers a polished “under construction” page with minimal setup.
By leveraging existing layout, Bootstrap, and jQuery plugins, it provides:

  • A responsive design
  • A live countdown
  • A central illustrative graphic

To extend, consider:

  • Dynamically fetching the target date from an API
  • Adding a newsletter signup form
  • Incorporating analytics for visitor tracking

This template is your go‑to for any feature rollout or site‑wide maintenance window. Enjoy!