Skip to content

Commit

Permalink
Merge develop master (#363)
Browse files Browse the repository at this point in the history
* bump to 13.2.7521

* Updated packed.lock

* Merge from patches 13.2.7521 (#258)

* Upgrade Angular to  v11 (#260)

* merge develop to master (#147)

* Fix E2E tests using the new navigation (#137)

* fix e2e (#143)

* Array of GUIDs custom field (#144)

* Array of GUIDs custom field

* Refactor tests to use dynamic items and not hardcoded (#145)

* Readme fix

* Vandov/merge develop to master (#151)

* Fix E2E tests using the new navigation (#137)

* fix e2e (#143)

* Array of GUIDs custom field (#144)

* Array of GUIDs custom field

* Refactor tests to use dynamic items and not hardcoded (#145)

* Upgrade to latest angular and fix audit issues (#141)

* Upgrade to latest angular and fix audit issues

* Fixed md file formatting

* empty ciommit

* Merge develop to master (#184)

* Merge develop to master (#214)

* Fix documentation links

* update packages

* rm

* space

* package

* restore readme

Co-authored-by: jmeleshko <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Gabriel <[email protected]>

* Bump version (#268)

* Мerge from patches (#269)

* Update sdk to 13.2.7523 (#270)

* Merge patches to develop (#271)

* Add wait for kendo popup (#272)

Co-authored-by: Decho Dechev - Progress <[email protected]>

* Update custom column sample to display related image

* Bump sdk to 7524

* doc

* impl

* remove focus

* update doc

* dummy

* Add documentation for change owner (#283)

* Bump progress-sitefinity-adminapp-sdk package version (#285)

* bump

* bump in packckage-lock

Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

* fix test

* Rename

* revert the name of adminapp-sdk

* update adminapp-sdk package name

* Merge patches -> develop (#292)

* Add documentation for change owner (#283)

* Bump progress-sitefinity-adminapp-sdk package version (#285)

* bump

* bump in packckage-lock

Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: jmeleshko <[email protected]>

* July/merge develop to patches (#297)

* Merge from patches 13.2.7521 (#258)

* Upgrade Angular to  v11 (#260)

* merge develop to master (#147)

* Fix E2E tests using the new navigation (#137)

* fix e2e (#143)

* Array of GUIDs custom field (#144)

* Array of GUIDs custom field

* Refactor tests to use dynamic items and not hardcoded (#145)

* Readme fix

* Vandov/merge develop to master (#151)

* Fix E2E tests using the new navigation (#137)

* fix e2e (#143)

* Array of GUIDs custom field (#144)

* Array of GUIDs custom field

* Refactor tests to use dynamic items and not hardcoded (#145)

* Upgrade to latest angular and fix audit issues (#141)

* Upgrade to latest angular and fix audit issues

* Fixed md file formatting

* empty ciommit

* Merge develop to master (#184)

* Merge develop to master (#214)

* Fix documentation links

* update packages

* rm

* space

* package

* restore readme

Co-authored-by: jmeleshko <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Gabriel <[email protected]>

* Мerge from patches (#269)

* Merge patches to develop (#271)

* Rename

* revert the name of adminapp-sdk

* update adminapp-sdk package name

* Merge patches -> develop (#292)

* Add documentation for change owner (#283)

* Bump progress-sitefinity-adminapp-sdk package version (#285)

* bump

* bump in packckage-lock

Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: jmeleshko <[email protected]>

Co-authored-by: Stoyan Ruzmanov <[email protected]>
Co-authored-by: Gabriel Belchev <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

* fix tests

* remove dummy

* upgrade admin app sdk to version 13.3.7621 (#299)

* Merge patches to develop (#300)

* doc

* impl

* remove focus

* update doc

* dummy

* Add documentation for change owner (#283)

* Bump progress-sitefinity-adminapp-sdk package version (#285)

* bump

* bump in packckage-lock

Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

* fix test

* July/merge develop to patches (#297)

* Merge from patches 13.2.7521 (#258)

* Upgrade Angular to  v11 (#260)

* merge develop to master (#147)

* Fix E2E tests using the new navigation (#137)

* fix e2e (#143)

* Array of GUIDs custom field (#144)

* Array of GUIDs custom field

* Refactor tests to use dynamic items and not hardcoded (#145)

* Readme fix

* Vandov/merge develop to master (#151)

* Fix E2E tests using the new navigation (#137)

* fix e2e (#143)

* Array of GUIDs custom field (#144)

* Array of GUIDs custom field

* Refactor tests to use dynamic items and not hardcoded (#145)

* Upgrade to latest angular and fix audit issues (#141)

* Upgrade to latest angular and fix audit issues

* Fixed md file formatting

* empty ciommit

* Merge develop to master (#184)

* Merge develop to master (#214)

* Fix documentation links

* update packages

* rm

* space

* package

* restore readme

Co-authored-by: jmeleshko <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Gabriel <[email protected]>

* Мerge from patches (#269)

* Merge patches to develop (#271)

* Rename

* revert the name of adminapp-sdk

* update adminapp-sdk package name

* Merge patches -> develop (#292)

* Add documentation for change owner (#283)

* Bump progress-sitefinity-adminapp-sdk package version (#285)

* bump

* bump in packckage-lock

Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: jmeleshko <[email protected]>

Co-authored-by: Stoyan Ruzmanov <[email protected]>
Co-authored-by: Gabriel Belchev <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

* fix tests

* remove dummy

* upgrade admin app sdk to version 13.3.7621 (#299)

Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Gabriel Belchev <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: Stoyan Ruzmanov <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>

* Add extensibility for additional lifecycle hooks (#301)

* move to patches

* docs

Co-authored-by: Gabriel <[email protected]>

* improve doc

* Add note for decencies update (#302)

* add note for breaking hcanges

* fix typo

* remove near-identical snippets

* Revert "Merge branch 'develop' into koserkov/improve-doc"

This reverts commit b6c4db7, reversing
changes made to 1c31690.

* update adminapp sdk version (#308)

Co-authored-by: Mario Yordanov <[email protected]>

* Mario/merge patches develop (#309)

* doc

* impl

* remove focus

* update doc

* dummy

* Add documentation for change owner (#283)

* Bump progress-sitefinity-adminapp-sdk package version (#285)

* bump

* bump in packckage-lock

Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

* fix test

* July/merge develop to patches (#297)

* Merge from patches 13.2.7521 (#258)

* Upgrade Angular to  v11 (#260)

* merge develop to master (#147)

* Fix E2E tests using the new navigation (#137)

* fix e2e (#143)

* Array of GUIDs custom field (#144)

* Array of GUIDs custom field

* Refactor tests to use dynamic items and not hardcoded (#145)

* Readme fix

* Vandov/merge develop to master (#151)

* Fix E2E tests using the new navigation (#137)

* fix e2e (#143)

* Array of GUIDs custom field (#144)

* Array of GUIDs custom field

* Refactor tests to use dynamic items and not hardcoded (#145)

* Upgrade to latest angular and fix audit issues (#141)

* Upgrade to latest angular and fix audit issues

* Fixed md file formatting

* empty ciommit

* Merge develop to master (#184)

* Merge develop to master (#214)

* Fix documentation links

* update packages

* rm

* space

* package

* restore readme

Co-authored-by: jmeleshko <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Gabriel <[email protected]>

* Мerge from patches (#269)

* Merge patches to develop (#271)

* Rename

* revert the name of adminapp-sdk

* update adminapp-sdk package name

* Merge patches -> develop (#292)

* Add documentation for change owner (#283)

* Bump progress-sitefinity-adminapp-sdk package version (#285)

* bump

* bump in packckage-lock

Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: jmeleshko <[email protected]>

Co-authored-by: Stoyan Ruzmanov <[email protected]>
Co-authored-by: Gabriel Belchev <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

* fix tests

* remove dummy

* upgrade admin app sdk to version 13.3.7621 (#299)

* Add extensibility for additional lifecycle hooks (#301)

* move to patches

* docs

Co-authored-by: Gabriel <[email protected]>

* improve doc

* Add note for decencies update (#302)

* add note for breaking hcanges

* fix typo

* remove near-identical snippets

* Revert "Merge branch 'develop' into koserkov/improve-doc"

This reverts commit b6c4db7, reversing
changes made to 1c31690.

* update adminapp sdk version (#308)

Co-authored-by: Mario Yordanov <[email protected]>

Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Gabriel Belchev <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: jmeleshko <[email protected]>
Co-authored-by: Stoyan Ruzmanov <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>

* Update adminapp-sdk version from 13.3.7622 to 13.3.7623 (#310)

Co-authored-by: Dimitar Gaydardzhiev <[email protected]>

* Regenerate package-lock in e2e tests with node 14.16.1

* Regenerate package-lock in e2e tests with node 14.16.1

* Bump sdk to 13.3.7624 (#315)

* Merge from patches (#316)

* bump version (#321)

Co-authored-by: Mario Yordanov <[email protected]>

* Mario/merge patches develop (#322)

* Regenerate package-lock in e2e tests with node 14.16.1

* Bump sdk to 13.3.7624 (#315)

* bump version (#321)

Co-authored-by: Mario Yordanov <[email protected]>

Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>

* Update README.md

* Fix auth (#327)

Co-authored-by: Decho Dechev - Progress <[email protected]>

* Bumn adminapp sdk version to 13.3.7626 (#328)

* Merge from patches 13.3.7626 (#329)

* bump @progress/sitefinity-adminapp-sdk version to 7627

* Add related data sample

* improve doc

* move readme

* fix image

* add demo gif

* accomodate changed provider signature

* change doc

* add related news field to dynamic module mock

* add date pipe and add test

* update doc and resourses

* address comments

* add promise in test

* fix test

* fix

* Merge patches -> develop (#336)

* fix bull point bug and size (#337)

* Revert changes made after the BETA release (#338)

* Update SDK to 14.0.7650 (#339)

* Merge from master (#341)

* Return changes made after the BETA release (#343)

* Configure the date and time format of the date time fields (#344)

* add doc

* add doc

* change `useBrowserLocale` to bool

* add disclamer (#345)

* Merge patches -> develop (#347)

* Extensibility: add hook after view init (#332)

* add examples

* add test assert

* wait for elements in edit and grid to load before verifying afterViewInit

* verify array of expected console outputs

Co-authored-by: Mario Yordanov <[email protected]>

* Update SDK version to 13.3.7628 (#335)

* update sdk version (#346)

Co-authored-by: Mario Yordanov <[email protected]>

Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>

* Merge patches > develop (#351)

* Extensibility: add hook after view init (#332)

* add examples

* add test assert

* wait for elements in edit and grid to load before verifying afterViewInit

* verify array of expected console outputs

Co-authored-by: Mario Yordanov <[email protected]>

* Update SDK version to 13.3.7628 (#335)

* update sdk version (#346)

Co-authored-by: Mario Yordanov <[email protected]>

* update (#350)

Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>

* Update adminapp sdk to 13.3.7631 (#354)

* Extensibility: add hook after view init (#332)

* add examples

* add test assert

* wait for elements in edit and grid to load before verifying afterViewInit

* verify array of expected console outputs

Co-authored-by: Mario Yordanov <[email protected]>

* Update SDK version to 13.3.7628 (#335)

* update sdk version (#346)

Co-authored-by: Mario Yordanov <[email protected]>

* update (#350)

* Reordering the children of a hierarchical type (#352)

* Update adminapp sdk to 13.3.7631 (#353)

Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

* Update adminapp sdk to 13.3.7632 (#357)

* Extensibility: add hook after view init (#332)

* add examples

* add test assert

* wait for elements in edit and grid to load before verifying afterViewInit

* verify array of expected console outputs

Co-authored-by: Mario Yordanov <[email protected]>

* Update SDK version to 13.3.7628 (#335)

* update sdk version (#346)

Co-authored-by: Mario Yordanov <[email protected]>

* update (#350)

* Reordering the children of a hierarchical type (#352)

* Update adminapp sdk to 13.3.7631 (#353)

* Update adminapp sdk to 13.3.7632 (#356)

Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>

* Add warning that the config.json was removed in 7622 (#361)

* bump sdk (#362)

Co-authored-by: Mario Yordanov <[email protected]>

* await before async function

* test logging

* token logging

* moar logging

* remove logs

Co-authored-by: Velin Ivanov <[email protected]>
Co-authored-by: PROGRESS\sruzmano <[email protected]>
Co-authored-by: Gabriel Belchev <[email protected]>
Co-authored-by: jmeleshko <[email protected]>
Co-authored-by: KirilVandov <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Nikolai Novkirishki <[email protected]>
Co-authored-by: Katalina Dimitrova <[email protected]>
Co-authored-by: Gabriel <[email protected]>
Co-authored-by: Decho Dechev <[email protected]>
Co-authored-by: Decho Dechev - Progress <[email protected]>
Co-authored-by: Mario Yordanov <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: Stefan Koserkov <[email protected]>
Co-authored-by: Dimitar Gaydardzhiev <[email protected]>
Co-authored-by: Dimitar Gaydardzhiev <[email protected]>
Co-authored-by: Todor Mitskovski <[email protected]>
Co-authored-by: IrenaPankova <[email protected]>
  • Loading branch information
19 people authored Sep 17, 2021
1 parent 725a9ee commit cf0b878
Show file tree
Hide file tree
Showing 28 changed files with 511 additions and 25 deletions.
10 changes: 8 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,6 @@ Extensions packages are future proof, they will work with future versions of Sit

With the release of 13.3 due to the name change of one of our dependencies ( from "sitefinity-adminapp-sdk" - > to "@progress/sitefinity-adminapp-sdk). You will need to update the repo with our latest official version tag #13.3.7600.0 and rebuild your extension.

With the release of 13.3 due to the name change of one of our dependencies ( from "sitefinity-adminapp-sdk" - > to "@progress/sitefinity-adminapp-sdk). You will need to update the repo with our latest official version tag #13.3.7600.0 and rebuild your extension.

Before you start developing make sure to checkout the tag corresponding to your Sitefinity host version (see [quick start section](#quick-start)). This way you can be sure that the extension will work once you copy the package to your Sitefinity host. Extensions packages are future proof, they will work with future versions of Sitefinity, so you can upgrade your Sitefinity instance without worrying that you will break your extensions.

## Prerequisites
Expand Down Expand Up @@ -204,6 +202,8 @@ this.http.get(url).subscribe(response => { /* do work */ });

## Extensibility endpoints

> IMPORTANT - Please note that there is a known limitation, you cannot use the Angular binding syntax {{item.data.CreatedBy}}, when creating component HTML templates, you must use another binding, for example [textContent]="item.data.CreatedBy", or [innerHtml]="item.data.Content".

The Admin App provides you with several extensibility points for plugging your functionality in the interface.
You can find more details about the API we provide in the [API documentation](http://admin-app-extensions-docs.sitefinity.site/index.html).

Expand All @@ -229,9 +229,15 @@ Take a look at the following overview of the Admin App extension samples we prov
* [Admin App custom theme](./src/theme#custom-theme-for-sitefinity-cms-admin-app) - You can customize the appearance of the Admin App by modifying specific components of the user interface. For example, you can customize buttons’ color, background, and text, as well as other supplementary text on the UI.
* [Custom list components](./src/tree#custom-list-components) - This extension is used to replace a part of each item shown in the tree used throughout the AdminApp. Currently supported only for the related data functionality.
### Modifications done in the config.json
* [Change owner command](./src/change-owner#allowing-change-owner-command-in-adminapp) - By default the change owner command is available only for pages. You can also make it available for other content types.
* [Sections menu](./src/sections-menu#extending-sections-menu-functionality-in-adminapp) - By default the sections menu in the item edit screen is visible only when there are 5 or more field sections. You can control this behavior by changing the number of sections needed for the menu to be visible.
* [Search](./src/search#extending-search-functionality-in-adminapp) - By default when search is executed the AdminApp searches only by a content type's default field. This may not be enough, therefore you have the ability to define the fields to be used when search is performed per content type.

* [Change the date and time format of the date time fields](./src/change-date-format#configuring-the-date-and-time-format-of-the-date-time-fields) - A configuration that allows you to change the format of the date and time fields.

* [Reordering the children of a hierarchical type](./src/reorder-children-list#reordering-the-children-of-a-hierarchical-type) - This configuration allows the reordering of the child types in the contains column of hierarchical types with two or more children.
Binary file added assets/reorder-children-list.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/tree/RelatedDataCustomTreeComponent.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/tree/sample.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 3 additions & 3 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
"@angular/platform-browser": "11.0.3",
"@angular/platform-browser-dynamic": "11.0.3",
"@angular/router": "11.0.3",
"@progress/sitefinity-adminapp-sdk": "14.0.7650",
"@progress/sitefinity-adminapp-sdk": "14.0.7700",
"@types/node": "14.14.13",
"codelyzer": "5.1.2",
"karma": "5.2.3",
Expand Down
2 changes: 2 additions & 0 deletions src/__extensions_index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ import { ThemeModule } from "./theme";
import { SitefinityExtensionStore } from "@progress/sitefinity-adminapp-sdk/app/api/v1";
import { FieldsChangeModule } from "./fields-change";
import { WidgetEditorExtenderModule } from "./widget-editor";
import { RelatedDateExtenderModule } from "./tree/related-data";

declare var sitefinityExtensionsStore: SitefinityExtensionStore;

Expand All @@ -18,3 +19,4 @@ sitefinityExtensionsStore.addExtensionModule(ItemExtenderModule);
sitefinityExtensionsStore.addExtensionModule(ThemeModule);
sitefinityExtensionsStore.addExtensionModule(FieldsChangeModule);
sitefinityExtensionsStore.addExtensionModule(WidgetEditorExtenderModule);
sitefinityExtensionsStore.addExtensionModule(RelatedDateExtenderModule);
98 changes: 98 additions & 0 deletions src/change-date-format/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
# Configuring the date and time format of the date time fields

By default the date and time formats used by the date and time fields, for example the start and end dates of the event content items, are in the format `h:mm a` for the time component and `M/dd/yyyy` for the date component. You can change these formats by adding the following to the `config.json` file located in the `{rootDirectory}\SitefinityWebApp\AdminApp\` folder:

```json
{
"dateTimeFormat": {
"useBrowserLocale": true,
"browserLocaleFormatWidth": "long",
"timeFormat": "HH:mm",
"dateFormat": " d/MMM/yyyy"
}
}
```

The configurations work as follows:
* if `useBrowserLocale` is `true`, then the `timeFormat` and `dateFormat` will be disregarded.
* the `browserLocaleFormatWidth` can be either `short`, `medium` or `long`, if this property is not provided and `useBrowserLocale` is `true`, it will default to `short`
* there are certain limitation that apply to the `timeFormat` and `dateFormat`. The date format accepts only a certain subset of date formats and the time format accepts only a certain subset of time formats. You may find the supported formats below:

Example behavior of `useBrowserLocale` if the browser's language is English (US).
* If the `browserLocaleFormatWidth` is set to `long` the formats used in the date and time field will be `"h:mm:ss a"` and `"MMMM d, y"`, which will look like `9:22:13 am` and `July 10, 2021`.
* If the `browserLocaleFormatWidth` is set to `medium` the formats used in the date and time field will be `"h:mm:ss a"` and `"MMM d, y"`, which will look like `9:22:13 am` and `Jul 10, 2021`.
* If the `browserLocaleFormatWidth` is set to `short` the formats used in the date and time field will be `"h:mm a"` and `"M/d/yy"`, which will look like `9:22 am` and `7/10/2021`.


Date formats:
```
"yyyy-MM-dd", // 2000-11-06, ISO 8601
"yyyy/MM/dd", // 2000/11/06
"yyyy.MM.dd", // 2000.11.06
"yyyy MM dd", // 2000 11 06
"yyyy/M/d", // 2000/11/06 (no leading zero for the day and month)
"yyyy-M-d", // 2000-11-06 (no leading zero for the day and month)
"yyyy/M.d", // 2000.11.06 (no leading zero for the day and month)
"yyyy M d", // 2000 11 06 (no leading zero for the day and month)
"dd/MM/yyyy", // 06/11/2000
"dd-MM-yyyy", // 06-11-2000
"dd.MM.yyyy", // 06.11.2000
"dd MM yyyy", // 06 11 2000
"d/M/yyyy", // 6/11/2000 (no leading zero for the day and month)
"d-M-yyyy", // 6-11-2000 (no leading zero for the day and month)
"d.M.yyyy", // 6.11.2000 (no leading zero for the day and month)
"d M yyyy", // 6 11 2000 (no leading zero for the day and month)
"M/d/yyyy", // 11/6/2000 (no leading zero for the day and month)
"M-d-yyyy", // 11-6-2000 (no leading zero for the day and month)
"M.d.yyyy", // 11.6.2000 (no leading zero for the day and month)
"M d yyyy", // 11 6 2000 (no leading zero for the day and month)
"MM/dd/yyyy", // 11/06/2000
"MM-dd-yyyy", // 11-06-2000
"MM.dd.yyyy", // 11.06.2000
"MM dd yyyy", // 11 06 2000
"yy-MM-dd", // 00-11-06, ISO 8601
"yy/MM/dd", // 00/11/06
"yy.MM.dd", // 00.11.06
"yy MM dd", // 00 11 06
"yy/M/d", // 00/11/06 (no leading zero for the day and month)
"yy-M-d", // 00-11-06 (no leading zero for the day and month)
"yy/M.d", // 00.11.06 (no leading zero for the day and month)
"yy M d", // 00 11 06 (no leading zero for the day and month)
"dd/MM/yy", // 06/11/00
"dd-MM-yy", // 06-11-00
"dd.MM.yy", // 06.11.00
"dd MM yy", // 06 11 00
"d/M/yy", // 6/11/00 (no leading zero for the day and month)
"d-M-yy", // 6-11-00 (no leading zero for the day and month)
"d.M.yy", // 6.11.00 (no leading zero for the day and month)
"d M yy", // 6 11 00 (no leading zero for the day and month)
"M/d/yy", // 11/6/00 (no leading zero for the day and month)
"M-d-yy", // 11-6-00 (no leading zero for the day and month)
"M.d.yy", // 11.6.00 (no leading zero for the day and month)
"M d yy", // 11 6 00 (no leading zero for the day and month)
"MM/dd/yy", // 11/06/00
"MM-dd-yy", // 11-06-00
"MM.dd.yy", // 11.06.00
"MM dd yy", // 11 06 00
"d MMM yyyy", // 6 Nov 2000 (no leading zero for the day)
"d-MMM-yyyy", // 6-Nov-2000 (no leading zero for the day)
"MMM d yyyy", // Nov 6 2000 (no leading zero for the day)
"MMM-d-yyyy" // Nov-6-2000 (no leading zero for the day)
```

Time formats:

```
"H:mm", // 21:15 (no leading zero for the hour)
"HH:mm", // 21:15
"H:mm:ss", // 21:15:00 (no leading zero for the hour)
"HH:mm:ss", // 21:15:00
"h:mm a", // 9:15 PM (no leading zero for the hour)
"hh:mm a", // 09:15 PM
"h:mm:ss a", // 9:15:00 PM (no leading zero for the hour)
"hh:mm:ss a" // 09:15:00 PM
```

> **Important notes**:
> * As of Sitefinity 13.3.7622.0 the `config.json` file is no longer shipped with the product.
> * The `config.json` file is located in `{{project_root}}/SitefinityWebApp/AdminApp`, if it is missing please create your own file so that you may apply the desired configurations.
5 changes: 4 additions & 1 deletion src/change-owner/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,7 @@ The array should contain the type names of the content types that should have th
}
```

Note: The command will always be available for Pages regardless of the value of the **changeOwnerAllowedTypes** property.
> **Important notes**:
> * The command will always be available for Pages regardless of the value of the **changeOwnerAllowedTypes** property.
> * As of Sitefinity 13.3.7622.0 the `config.json` file is no longer shipped with the product.
> * The `config.json` file is located in `{{project_root}}/SitefinityWebApp/AdminApp`, if it is missing please create your own file so that you may apply the desired configurations.
3 changes: 3 additions & 0 deletions src/commands-extender/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,9 @@
* [Example](#example)

## Overview

> IMPORTANT - Please note that there is a known limitation, you cannot use the Angular binding syntax {{item.data.CreatedBy}}, when creating component HTML templates, you must use another binding, for example [textContent]="item.data.CreatedBy", or [innerHtml]="item.data.Content".
You can register custom command and execute some custom logic when executing them. They can be added in several places:
* in the Grid View
* next to the Create command
Expand Down
2 changes: 1 addition & 1 deletion src/commands-extender/print-preview.component.html
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
<div style="position: fixed;top: 50%;left: 50%;">
<h1 *ngIf="dataItem">{{dataItem.Title}}</h1>
<h1 *ngIf="dataItem" [textContent]="dataItem.Title"></h1>
<h1 *ngIf="!dataItem">Loading..</h1>
</div>
2 changes: 2 additions & 0 deletions src/custom-fields/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Custom field

> IMPORTANT - Please note that there is a known limitation, you cannot use the Angular binding syntax {{item.data.CreatedBy}}, when creating component HTML templates, you must use another binding, for example [textContent]="item.data.CreatedBy", or [innerHtml]="item.data.Content".
When in content editing mode, content editors can modify content properties and add content relations via dedicated fields in the UI. For example, **ShortText**, **LongText**, **Number**, **Classifications**, **RelatedData**, and so on. With the Admin App, you can replace one of the default fields when creating and editing items with a custom one. In addition, you can implement a custom visualization for each custom field you create. You do this by providing a custom implementation of the [**FieldsProvider**](http://admin-app-extensions-docs.sitefinity.site/interfaces/fieldsprovider.html) interface. For each field rendered in the UI, the [**overrideField**](http://admin-app-extensions-docs.sitefinity.site/interfaces/fieldsprovider.html#overridefield) method is called. You can also provide a custom field registration for all of the fields or for a specific one.
You also need to provide an implementation of the field for both read and write actions because there may be a case when due to lack of proper permissions or because the item is locked, it cannot be edited.

Expand Down
8 changes: 7 additions & 1 deletion src/grid-extender/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Custom grid

> IMPORTANT - Please note that there is a known limitation, you cannot use the Angular binding syntax {{item.data.CreatedBy}}, when creating component HTML templates, you must use another binding, for example [textContent]="item.data.CreatedBy", or [innerHtml]="item.data.Content".
You can add custom columns in the grid that show more information about the specific data item, for example related data or media, or any other kind of information, like data from external systems. What is more you can also remove some of the existing columns that bring no value to you. In order to achieve this, you have to use a specific extensibility point. A custom implementation of the [**ListColumnsProvider**](http://admin-app-extensions-docs.sitefinity.site/interfaces/listcolumnsprovider.html) interface must be provided.

Its method [**getColumns()**](http://admin-app-extensions-docs.sitefinity.site/interfaces/listcolumnsprovider.html#getcolumns) is used to add new custom columns. The method returns an **Observable** of the [**ColumnModel**](http://admin-app-extensions-docs.sitefinity.site/interfaces/columnmodel.html) object.
Expand Down Expand Up @@ -75,4 +77,8 @@ Where you see `newsitems` and `pressreleases`, these keys are the so-called enti

## Example

![Image column](./../../assets/image-column.JPG)
![Image column](./../../assets/image-column.JPG)

> **Important notes**:
> * As of Sitefinity 13.3.7622.0 the `config.json` file is no longer shipped with the product.
> * The `config.json` file is located in `{{project_root}}/SitefinityWebApp/AdminApp`, if it is missing please create your own file so that you may apply the desired configurations.
2 changes: 2 additions & 0 deletions src/item-extender/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,13 @@ The supported states for which you can hook are:
- when the list view component is initializing -> *onGridItemsInitializing()* hook
- when the items in the list view are changed(for example when some item is deleted) -> *onGridItemsChanged()* hook
- when the list view component is being destroyed -> *onGridItemsUnloading()* hook
- when the list view component is initialized (ngAfterViewInit angular hook) -> *afterGridInit()* hook

- **Edit/Create view**
- when the single item view is initializing -> onEditItemInitializing() hook
- when the item that is open is changed -> onEditItemChanged() hook
- when the single item view is being destroyed -> onEditItemUnloading() hook
- when the single item view is initialized (ngAfterViewInit angular hook) -> afterEditItemInit() hook


For each of the hooks, object will be passed containing the list view items or the item open for edit.
8 changes: 8 additions & 0 deletions src/item-extender/item-hooks-provider.ts
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,10 @@ class CustomItemHooksProvider implements ItemHooksProvider {
return this.executeOperation(`Item unloading: ${data.item?.data?.Title || "No item"}`);
}

afterEditItemInit(data: EditLifecycleHookParam): Observable<void> {
return this.executeOperation(`After edit item init: ${data.item?.data?.Title || "No item"}`);
}

onGridItemsChanged(data: ListLifecycleHookParam): Observable<void> {
return this.executeOperation(`Grid items changing: ${data.items?.length ? data.items.map(x => x.data.Title) : "No items"}`);
}
Expand All @@ -38,6 +42,10 @@ class CustomItemHooksProvider implements ItemHooksProvider {
return this.executeOperation(`Grid items unloading: ${data.items?.length ? data.items.map(x => x.data.Title) : "No items"}`);
}

afterGridInit(data: ListLifecycleHookParam): Observable<void> {
return this.executeOperation(`After grid init: ${data.items?.length ? data.items.map(x => x.data.Title) : "No items"}`);
}

private executeOperation(message: string): Observable<void> {
const result$ = new ReplaySubject<void>();

Expand Down
24 changes: 24 additions & 0 deletions src/reorder-children-list/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Reordering the children of a hierarchical type

This configuration concerns the "contains" column of a hierarchical module with two or more child types.

![Example](./../../assets/reorder-children-list.png "Example")

In this example there is parent type called "Countries" which has two child types - "Town" and "Territory", which by default are displayed in this order, and if you click on the parent item, in this example "Bulgaria", the first child type list screen will be opened - the "Towns" list.

To rearrange the child types, find the `config.json` file located in `{{your_project_root}}\SitefinityWebApp\AdminApp`, and in it use the following configuration:

```json
"dynamicModuleChildListOrder": [
{
"parentEntitySet": "countries",
"childEntitySets": ["territories", "towns"]
}
]
```

After this configuration is applied the "contains" column will now list the types in the order of "territories" and "towns" and when the parent is click it will redirect to the territories list view.

> **Important notes**:
> * As of Sitefinity 13.3.7622.0 the `config.json` file is no longer shipped with the product.
> * The `config.json` file is located in `{{project_root}}/SitefinityWebApp/AdminApp`, if it is missing please create your own file so that you may apply the desired configurations.
4 changes: 4 additions & 0 deletions src/search/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,3 +25,7 @@ Search settings are per content type. For example, if you want to configure sear
To target given content type, you have to use its entity set name as key and an array with the names of the fields that should be used when searching as value.
For example the code from the sample will configure the search so that the Content field would be used for finding news.
If you don't provide configuration, the default field will be used.

> **Important notes**:
> * As of Sitefinity 13.3.7622.0 the `config.json` file is no longer shipped with the product.
> * The `config.json` file is located in `{{project_root}}/SitefinityWebApp/AdminApp`, if it is missing please create your own file so that you may apply the desired configurations.
5 changes: 4 additions & 1 deletion src/sections-menu/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,4 +21,7 @@ Then you need to add another property **sectionsMenuMinColumnsNumber** of type n
}
```

NOTE: If you don't provide this configuration, the default value - 5, will be used.
> **Important notes**:
> * If you don't provide the configuration for `sectionsMenuMinColumnsNumber` the default value `5`, will be used.
> * As of Sitefinity 13.3.7622.0 the `config.json` file is no longer shipped with the product.
> * The `config.json` file is located in `{{project_root}}/SitefinityWebApp/AdminApp`, if it is missing please create your own file so that you may apply the desired configurations.
Loading

0 comments on commit cf0b878

Please sign in to comment.