📄 Documentation: ComingSoon1.cshtml
📑 Table of Contents
- Overview & Purpose
- Layout Definition & ViewBag
- HTML Structure & Key Functional Areas
- Dependencies & Technologies
- View Models & Data Models
- Helper Methods & Utilities
- Third‑party Integrations
- Error Handling & Return Types
- API Endpoints Overview
- UML Diagram
- Usage Examples
- 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.cshtmlwhich 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
– Currently disabled; can be toggled on to allow returning to the home page.@* <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> *@
3.2 Maintenance Image 🖼️
- Renders
~/images/coming-soon.svgcentrally with Bootstrap’s responsive classes. - Encourages engagement with a graphic representation of “maintenance”.
3.3 Countdown Timer ⏳
- Uses a
divwithdata-countdownattribute (format: YYYY/MM/DD). - Class:
counter-number - Initialized via the jQuery Countdown plugin in
coming-soon.init.js.
3.4 Footer Scripts & Assets 🔧
<!-- 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 🔗
- jQuery Countdown – Provides date calculation & live timer UI.
- Bootstrap – Layout grid & utility CSS.
- MetisMenu & Simplebar – Enhanced navigation & scrollbar.
- 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-countdownis 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
- Change Launch Date
<div data-countdown="2023/12/25" class="counter-number"></div> - 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> - Custom Styling
Override.maintenance-img imgin 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!