$core_v2_widget.GetStringValue() vs. GetHtmlValue()?

Robert Hanson said:

Q: $core_v2_widget.GetStringValue() converted the URL in an HTML snippet (shown below).  Why does it do this, and are there any other transformations that it performs?

File embedding is enabled for HTML fields, but not string fields. Internally, we resolve URLs to local resources to "application root", inspect if they reference files (if they do, we'll collect the file resources and associate them for proper permission checking), and store the values in this escaped format to make them more portable.

Robert Hanson said:

Q: How does $core_v2_widget.GetHtmlValue() differ from $core_v2_widget.GetStringValue()?

The only notable difference is the resolution of embedded local URLs.

Robert Hanson said:

Q: $core_v2_ui.Render() is supposed to make the content "safe".  What does "safe" mean?  And how do the transformations change when you use the optional "target" value?

The core_v2_ui.Render method allows plugins that handle Html.Render events to process disconnected content (these events are automatically executed when API entities, such as blog posts, have their body rendered but can be manually executed when the content is disconnected). HTML render event handlers include: Emoticon processing, float clearing (to prevent content overflowing its HTML container), embedded content processing (code, polls, etc), and file viewers. The event itself is an extensibility point, so other plugins can participate and adjust the content provided to the core_v2_ui.Render() call.

The target provided is passed through the Render event to allow each handler to execute differently based on the rendering target. For example, emoticons will render differently when rendered to "Web" than to "Email".

That is very cool.  Thanks for the info.