sp-dev-fx-webparts/samples/react-world-clocks/README.md

104 lines
5.7 KiB
Markdown
Raw Normal View History

2020-11-09 00:21:58 -05:00
# World Clocks
2020-09-26 15:57:39 -04:00
## Summary
- This sample is extension of the single World time clock sample that was provided in SP Starter Kit.
- This web part use SharePoint List to Show multiple Clocks.
- Each clock item can have Name, Timezone and status (Active, Yes/No).
2020-10-02 02:15:00 -04:00
- The web part properties will allow you to enter Web Part Title and select a List.
- The web part properties will allow you to show or hide time.
2020-09-26 15:57:39 -04:00
- You can show or hide clocks by setting the status to active or inactive.
- The web part does not update automatically. [Someone need to make the React Tick :)]
![Web Part](./assets/WebPart.png)
### Web Part in Action
![Web Part in Action](./assets/ClocksInAction.gif)
### Usage
**1) Create or use a list for World Clocks. The List should have the following Columns:**
2021-11-06 18:21:51 -04:00
- `Title`, `GMTValues`, `ListOrder`, `IsActive`.
2020-09-26 15:57:39 -04:00
![Create list for use with the World Clocks](./assets/WorldClockList.png)
2020-10-02 02:15:00 -04:00
- [World Clocks list Template for use with the Web Part](./assets/WorldClock.stp)
- [World Clocks Site Script use with the Web Part](./assets/WorldClock.json)
2020-09-26 15:57:39 -04:00
**2) Add the World Clocks web part to your page & Enter Title, Select List. You can also enable the other required settings.**
2021-10-30 20:57:07 -04:00
## Compatibility
2020-09-26 15:57:39 -04:00
2021-10-30 20:57:07 -04:00
![SPFx 1.11](https://img.shields.io/badge/SPFx-1.11.0-green.svg)
2021-11-01 21:07:49 -04:00
![Node.js v10](https://img.shields.io/badge/Node.js-v10-green.svg)
2021-10-30 20:57:07 -04:00
![Compatible with SharePoint Online](https://img.shields.io/badge/SharePoint%20Online-Compatible-green.svg)
![Does not work with SharePoint 2019](https://img.shields.io/badge/SharePoint%20Server%202019-Incompatible-red.svg "SharePoint Server 2019 requires SPFx 1.4.1 or lower")
![Does not work with SharePoint 2016 (Feature Pack 2)](https://img.shields.io/badge/SharePoint%20Server%202016%20(Feature%20Pack%202)-Incompatible-red.svg "SharePoint Server 2016 Feature Pack 2 requires SPFx 1.1")
![Teams Incompatible](https://img.shields.io/badge/Teams-Incompatible-lightgrey.svg)
![Local Workbench Incompatible](https://img.shields.io/badge/Local%20Workbench-Incompatible-red.svg "This solution requires access to a list")
![Hosted Workbench Compatible](https://img.shields.io/badge/Hosted%20Workbench-Compatible-green.svg)
2020-09-26 15:57:39 -04:00
## Applies to
- [SharePoint Framework](https://docs.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)
- [Office 365 tenant](https://docs.microsoft.com/sharepoint/dev/spfx/set-up-your-development-environment)
## Prerequisites
- A package is available for direct download.
Please create the list as described above
## Solution
| Solution | Author(s) |
| --------------------- | ---------------------------------------- |
| World Clocks Web Part | [Jerry Yasir](https://github.com/jyasir) |
## Version history
| Version | Date | Comments |
| ------- | ------------------ | ------------- |
| 1.0 | September 26, 2020 | First Version |
## Minimal Path to Awesome
- Clone or download this repository
2021-11-06 18:21:51 -04:00
- From your command line, change your current directory to the directory containing this sample (`react-world-clocks`, located under `samples`)
2020-09-26 15:57:39 -04:00
- Run in command line:
- `npm install` to install the npm dependencies
- `gulp serve` to display in Developer Workbench (recommend using your tenant workbench so you can test with real lists within your site)
- To package and deploy:
- Use `gulp bundle --ship` & `gulp package-solution --ship`
- Add the `.sppkg` to your SharePoint App Catalog
2021-11-06 18:21:51 -04:00
## Video
[![Implementing a World Clocks web part with SharePoint Framework](./assets/video-thumbnail.jpg)](https://www.youtube.com/watch?v=91uQHUgpKo8 "Implementing a World Clocks web part with SharePoint Framework")
2021-10-30 20:57:07 -04:00
## Help
2021-11-06 18:21:51 -04:00
We do not support samples, but this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.
If you're having issues building the solution, please run [spfx doctor](https://pnp.github.io/cli-microsoft365/cmd/spfx/spfx-doctor/) from within the solution folder to diagnose incompatibility issues with your environment.
You can try looking at [issues related to this sample](https://github.com/pnp/sp-dev-fx-webparts/issues?q=label%3A%22sample%3A%20react-world-clocks") to see if anybody else is having the same issues.
2021-11-06 18:21:51 -04:00
You can also try looking at [discussions related to this sample](https://github.com/pnp/sp-dev-fx-webparts/discussions?discussions_q=react-world-clocks) and see what the community is saying.
2021-10-30 20:57:07 -04:00
2021-11-20 23:55:10 -05:00
If you encounter any issues while using this sample, [create a new issue](https://github.com/pnp/sp-dev-fx-webparts/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Abug-suspected%2Csample%3A%20react-world-clocks&template=bug-report.yml&sample=react-world-clocks&authors=@jyasir&title=react-world-clocks%20-%20).
2021-10-30 20:57:07 -04:00
2021-11-20 23:55:10 -05:00
For questions regarding this sample, [create a new question](https://github.com/pnp/sp-dev-fx-webparts/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Aquestion%2Csample%3A%20react-world-clocks&template=question.yml&sample=react-world-clocks&authors=@jyasir&title=react-world-clocks%20-%20).
2021-10-30 20:57:07 -04:00
2021-11-20 23:55:10 -05:00
Finally, if you have an idea for improvement, [make a suggestion](https://github.com/pnp/sp-dev-fx-webparts/issues/new?assignees=&labels=Needs%3A+Triage+%3Amag%3A%2Ctype%3Aenhancement%2Csample%3A%20react-world-clocks&template=question.yml&sample=react-world-clocks&authors=@jyasir&title=react-world-clocks%20-%20).
2021-10-30 20:57:07 -04:00
2021-11-07 02:11:17 -05:00
## Disclaimer
**THIS CODE IS PROVIDED *AS IS* WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.**
2020-09-26 15:57:39 -04:00
<img src="https://telemetry.sharepointpnp.com/sp-dev-fx-webparts/samples/react-world-clocks" />