|
| 1 | +--- |
| 2 | +layout: default |
| 3 | +group: pattern |
| 4 | +subgroup: Staging Patterns |
| 5 | +title: Magento Admin Pattern Library |
| 6 | +menu_title: Timeline Dashboard |
| 7 | +menu_order: 1 |
| 8 | +menu_node: |
| 9 | +github_link: pattern-library/staging-patterns/TimelineDashboard/Timeline-Dashboard.md |
| 10 | +--- |
| 11 | +<img src="img/ee-only_large.png"> |
| 12 | + |
| 13 | +<h2> Timeline Dashboard </h2> |
| 14 | + |
| 15 | +<h3> Contents </h3> |
| 16 | + |
| 17 | +* <a href="#overview">Overview</a> |
| 18 | +* <a href="#when-to-use">When to Use / When Not to Use</a> |
| 19 | +* <a href="#terminology">Staging terminology and definitions</a> |
| 20 | +* <a href="#examples">Interaction and Behavior</a> |
| 21 | +* <a href="#assets">Assets</a> |
| 22 | + |
| 23 | +<h3 id="overview">Overview</h3> |
| 24 | +This dashboard provides a page where events and processes can be viewed and managed in one place. <br> |
| 25 | + |
| 26 | +Staging usage: Within Magento, users need to see which stage-able entities are published or scheduled to be published. Since most of Magento’s entities can be staged – the display of all this information is important to show users the full scope of updates at a glance. |
| 27 | + |
| 28 | + |
| 29 | + |
| 30 | +<h3 id="when-to-use">When to Use / When Not to Use</h3> |
| 31 | +Use when events and processes need to be displayed sequentially, along a timeline, and when multiple items are combined in one view. Example: Scheduled updates on staging. <br> |
| 32 | +Do not use a timeline as an alternative display mode for tree, card or data table views. |
| 33 | + |
| 34 | +<h3 id="terminology">Staging terminology and definitions</h3> |
| 35 | + |
| 36 | +#### Stage-able entity: |
| 37 | +A part of Magento that can be scheduled to change, within an update. Examples: Products, Categories<br> |
| 38 | + |
| 39 | +#### Update: |
| 40 | +A combination of changes to a stage-able entity. Multiple updates are shown on the staging timeline. An update’s state is either completed, active or scheduled to be activated.Most updates are scheduled for a temporary span of time, but some can be permanent. <br> |
| 41 | + |
| 42 | +#### Objects: |
| 43 | +These are the individual changes contained within an update.<br> |
| 44 | + |
| 45 | + |
| 46 | + |
| 47 | +<h3 id="examples">Interaction and Behavior</h3> |
| 48 | + |
| 49 | +#### What markers mean on timeline: |
| 50 | + |
| 51 | + |
| 52 | +<img src="img/Staging_Dashboard_0006_timeline_notes.jpg"> |
| 53 | +<br> |
| 54 | + |
| 55 | +1. “Past” link in header of timeline is a link to the Change Log, a list of past updates, including both those with end dates and ‘permanent’ updates (without end dates). |
| 56 | + |
| 57 | +2. ‘Permanent’ updates are collected in an Active Permanent Updates bar that appears at the top pf the timeline. This bar should display a # of updates relative to the “From” date set for the timeline. This text is a link that leads to a Change Log that only contains the Permanent Updates, unlike the change log associated with the “Past” link. |
| 58 | + |
| 59 | +3. The control to move the time line to the left is disabled when the “Past” column is in view. Once the timeline is scrolled to see upcoming events the control becomes active. |
| 60 | + |
| 61 | +4. The user can scroll the timeline to see upcoming updates by tapping the arrow on an update, scolling the timeline with scroll control, or the right arrow. |
| 62 | + |
| 63 | + |
| 64 | + |
| 65 | +#### Update schedule: |
| 66 | +As the default state, this view shows completed, active and scheduled updates on the dashboard. The timeline’s default date range is 1 week, which can be changed and customized.Updates are displayed in chronological order, with the most recent start date on top. |
| 67 | +<img src="img/Updates-Scheduled.jpg"> |
| 68 | + |
| 69 | +#### Update Summary, in Overlay Window: |
| 70 | +When clicked, a bar on the timeline spawns an overlay window, showing a summary of the objects contained in the update. The window includes controls to edit or preview the update. |
| 71 | +<img src="img/Timeline-Dashboard-summary.jpg"> |
| 72 | + |
| 73 | +#### 4-Week Zoom Control: |
| 74 | +A slider control at the bottom of the page allows users to zoom out from 1 week to 4 weeks, viewing a bigger timeline of updates. |
| 75 | +<img src="img/4-week-zoom.jpg"> |
| 76 | + |
| 77 | +#### “Load More” Control: |
| 78 | +On the default timeline view, the number of updates displayed is set to 10. Clicking “Load More” adds more updates on the timeline. A grid menu control changes the number of items displayed per page. |
| 79 | +<img src="img/load-more.jpg"> |
| 80 | + |
| 81 | +#### Horizontal Scrolling for Future Updates: |
| 82 | +A horizontal scrollbar at the bottom of the timeline provides the capability to view future updates that do not fit inside the span of the page. This scrollbar is usually not displayed. |
| 83 | +<img src="img/scrolled-to-future.jpg"> |
| 84 | + |
| 85 | +#### Prioritized Timeline View, with Drag and Drop: |
| 86 | +This is a variation of the timeline. This view only appears when stage-able entities on the timeline need to be ordered by priority. In the example displayed below – the priority scale has been used to display the sort order of the rules. To re-arrange the order, an item on the timeline can be dragged and moved. |
| 87 | +<img src="img/priority-schedule.jpg"> |
| 88 | + |
| 89 | +#### Data Table View: |
| 90 | +This is an alternative view to the timeline in data table format. The functionalities of the timeline and the data table are consistent except for the pagination feature, which is used for data table view only. |
| 91 | +<img src="img/table-view.jpg"> |
| 92 | + |
| 93 | + |
| 94 | + |
| 95 | +<h3 id="styling">Styling</h3> |
| 96 | + |
| 97 | +####Updates schedule: |
| 98 | +<img src="img/styles/style_staging_dashboard.jpg"> |
| 99 | + |
| 100 | +####Update Summary, in Overlay Window: |
| 101 | +<img src="img/styles/style-summary.jpg"> |
| 102 | + |
| 103 | + |
| 104 | +<h3 id="assets">Assets</h3> |
| 105 | + |
| 106 | +If you have questions about the Timeline Dashboard, please <a href="https://magento.com/company/contact-us">contact us.</a> |
| 107 | + |
| 108 | +<a href="src/timeline-dashboard.psd">Download Timeline Dashboard source</a> |
0 commit comments