Upgrading docs (#7960)

This commit is contained in:
Damian Mooyman 2018-04-05 09:42:07 +12:00 committed by Aaron Carlino
parent f29ceec70d
commit c23d21a255

View File

@ -60,3 +60,34 @@ conversion of the reading mode between:
- Reading mode string
- DataQuery parameters
- Querystring parameters
### Link tracking
SiteTreeLinkTracking has been split and refactored into two extensions, and now
no longer applies exclusively to `HTMLContent` areas on `SiteTree` objects, but now
all `DataObject` classes.
- `SiteTreeLinkTracking` -> Tracks links between any object and SiteTree objects,
generated from [sitetree_link] shortcodes in html areas.
- `FileLinkTracking` -> Tracks links between any object and File objects, generated
from [image] and [file_link] shortcodes in html areas.
Note that the `ImageTracking` property has been deprecated in favour of `FileTracking`,
which includes and tracks non-image files as well.
By default `HasBrokenFile` and `HasBrokenLink` properties are still supported, but
only for `SiteTree` objects by default. Non-SiteTree objects will still have
both `FileTracking` and `LinkTracking` relations available for tracking
linked records.
In addition, `File::BackLinkTracking()` and `SiteTree::BackLinkTracking()` are now polymorphic,
and may now both contain non-SiteTree objects. Polymorphic many_many through relations are
currently experimentally supported.
User code which relies on SiteTree-only results for these properties will need to be updated
to consider other types.
Additionally, the `SiteTree_LinkTracking` and `SiteTree_ImageTracking` tables no longer exist,
and are replaced by the `SiteTreeLink` and `FileLink` many_many through joining classes instead.
Code which relies on raw SQL queries to these tables will need to be updated.
`SiteTreeFileExtension` is deprecated, and has it's functionality baked directly into `File` dataobject.