---

Class ::xowiki::formfield::include

::xowiki::formfield::include create ... \
           [ -resolve_local (default "false") ]

Class Relations

• class: ::xotcl::Class
• superclass: ::xowiki::formfield::text

::xotcl::Class create ::xowiki::formfield::include \
     -superclass ::xowiki::formfield::text

Methods (to be applied on instances)

• pretty_value (scripted)

  if {$v eq ""} { return $v }
  
  set item_id [${:object} get_property_from_link_page item_id 0]
  :log "##### include in ${:object} '[${:object} name]': get_property_from_link_page ${:object} item_id => <$item_id> (resolve_local ${:resolve_local})"
  if {$item_id == 0} {
    # Here, we could call "::xowiki::Link render" to offer the user means
    # to create the entry like with [[..]], if he has sufficient permissions...;
    # when $(package_id) is 0, the referenced package could not be
    # resolved
    return "Cannot resolve symbolic link '$v'"
  }
  set link_type [${:object} get_property_from_link_page link_type]
  ${:object} references resolved [list $item_id $link_type]
  set item ::$item_id
  
  if {${:resolve_local}} {
    #
    # Resetting esp. the item_id is dangerous.
    # Therefore, we reset it immediately after the rendering.
    #
    #:log "#### RESOLVE LOCAL: setting for $item [$item name] set_resolve_context -parent_id [${:object} parent_id] -item_id [${:object} item_id]"
    $item set __RESOLVE_LOCAL 1
    $item set_resolve_context  -package_id [${:object} package_id] -parent_id [${:object} parent_id]  -item_id [${:object} item_id]
  
    set html [$item render -update_references never]
  
    $item unset __RESOLVE_LOCAL
    $item reset_resolve_context
  } else {
    set html [$item render]
  }
  return $html

• resolve_local (setter)

---