Merge pull request #174 from karma4u101/develop

FoBo v2.1.0 release

Author: karma4u101

.travis.yml

@@ -1,6 +1,6 @@
  language: scala
  scala:
-   - "2.12.1"
+   - "2.12.7"
  jdk:
    - oraclejdk8
 

Bootstrap/Bootstrap4/TwBs-Bootstrap4-API/README.md

@@ -0,0 +1,42 @@
+# FoBo TwBs Bootstrap4 API Module
+
+This FoBo API module provides FoBo/Lift API components for the TwBs Bootstrap4 Toolkit Module, 
+but can also be used as-is, see below for setup information.
+
+## Integration into your project 
+
+### Dependency settings
+
+Example setup:
+
+```scala
+"net.liftmodules" %% "fobo-twbs-bootstrap4-api_3.3 % "2.1"
+```
+```xml
+<dependency>
+  <groupId>net.liftmodules</groupId>
+  <artifactId>fobo-twbs-bootstrap4-api_3.3_2.12.6</artifactId>
+  <version>2.1</version>
+</dependency>
+```
+The example will include the FoBo Bootstrap4 API module v2.1 built for Lift 3.3.x. 
+If you are using maven observe that the artifact id also needs the Scala version.
+
+### Lift FoBo boot hooks (when used in the FoBo module)
+```scala
+import net.liftmodules.fobo 
+  :
+fobo.API.init = fobo.API.Bootstrap4 
+```    
+
+### Lift FoBo boot hooks (when used as stand alone module)
+```scala
+import net.liftmodules.{fobobsapi => fobo} 
+  :
+fobo.API.init = fobo.API.Bootstrap4 
+ ```  
+### Contributions
+
+Improvements, contributions and suggestions are welcome! Please see the [Contribution Document](https://github.com/karma4u101/FoBo/blob/master/CONTRIBUTING.md). 
+You can also leave a issue report or drop a question/suggestion on [Lift's mailing list](http://groups.google.com/group/liftweb/) 
+

Bootstrap/Bootstrap4/TwBs-Bootstrap4-API/src/main/scala/net/liftmodules/fobobs4/lib/BootstrapSH.scala

@@ -14,10 +14,10 @@ import net.liftweb.http.js.JsCmd
   * ==Bootstrap Script Helper Bootstrap v4.x==
   * Bootstrap script helper is a helper class that implements some commonly
   * used bootstrap component init/usage script functions.
-  * This convenience script functions is used in the [[net.liftmodules.FoBoBs.snippet.FoBo.Bs4Comp]]
+  * This convenience script functions is used in the [[net.liftmodules.fobobs4.snippet.FoBo.Bs4Comp]]
   * snippet but can also be used as a convenience helper in your own customized snippets.
   *
-  * @example If you find that the [[net.liftmodules.FoBoBs.snippet.FoBo.Bs4Comp]] snippet dose not fit you exact needs
+  * @example If you find that the [[net.liftmodules.fobobs4.snippet.FoBo.Bs4Comp]] snippet dose not fit you exact needs
   * your can still use the BootstrapSH class to customize your own project snippets.
   * {{{
   *   import net.liftmodules.FoBoBs.lib.{BootstrapSH=>sch}

Bootstrap/Bootstrap4/TwBs-Bootstrap4-API/src/main/scala/net/liftmodules/fobobs4/snippet/FoBo/Bs4Comp.scala

@@ -1,14 +1,14 @@
 package net.liftmodules.fobobs4.snippet.FoBo
 
-import scala.xml.{NodeSeq, Text}
+import scala.xml.{NodeSeq}
 import net.liftweb.util._
 import net.liftweb.common._
 import net.liftweb.http._
-import net.liftweb._
 import Helpers._
 import net.liftweb.http.js._
 import net.liftweb.http.js.JsCmds._
 import net.liftmodules.fobobs4.lib.{BootstrapSH => sch}
+import net.liftweb.sitemap.{Loc, SiteMap}
 
 /**
   * ==Bs4Component's Snippet Bootstrap v4.x==
@@ -25,6 +25,7 @@ class Bs4Comp extends StatefulSnippet with Loggable {
   private lazy val sch = new sch()
 
   def dispatch = {
+    case "breadCrumb"                    => breadCrumb
     case "popover"                       => popover
     case "popoverAppendJs"               => popoverAppendJs
     case "popoverPreventDefault"         => popoverPreventDefault
@@ -35,6 +36,54 @@ class Bs4Comp extends StatefulSnippet with Loggable {
     case "activateDropdownAppendJs"      => activateDropdownAppendJs
   }
 
+  /**
+    * This function creates a bootstrap breadCrumb component using Loc information from Lift.
+    *
+    * '''Snippet Params:'''
+    *
+    *  - '''Param''' ''prefix'' - A optional param to prefix the breadcrumb list with if it's value can
+    *    be found as a Loc.name.
+    *
+    * '''Example'''
+    * {{{ <script data-lift="FoBo.Bs4Comp.breadCrumb?prefix=Home"></script> }}}
+    *
+    * @since v2.0.1
+    */
+  def breadCrumb: CssSel = {
+    val locName              = S.attr("prefix") openOr ""
+    val aPrefix: Box[Loc[_]] = SiteMap.findLoc(locName)
+    var breadcrumbs: List[Loc[_]] =
+      for {
+        currentLoc <- S.location.toList
+        loc        <- currentLoc.breadCrumbs
+      } yield loc
+
+    breadcrumbs = aPrefix match {
+      case Full(prefix) => prefix :: breadcrumbs
+      case _            => breadcrumbs
+    }
+
+    " *" #> <nav aria-label="breadcrumb" role="navigation">
+      <ol class="breadcrumb">
+        {breadcrumbs.map { loc =>
+        val linkText = loc.linkText.openOr(NodeSeq.Empty)
+        val link = loc.createDefaultLink.getOrElse(NodeSeq.Empty)
+
+        if (loc == S.location.openOr(NodeSeq.Empty))
+          <li class="breadcrumb-item active" aria-current="page">
+            {linkText}
+          </li>
+        else
+          <li class="breadcrumb-item">
+            <a href={link}>
+              {linkText}
+            </a>
+          </li>
+      }}
+      </ol>
+    </nav>
+  }
+
   /**
     * This function sets a popover action on a element by inlining a script snippet on the page.
     *
@@ -112,7 +161,7 @@ class Bs4Comp extends StatefulSnippet with Loggable {
     *     // ]]>
     *   </script>
     * }}}
-    * @see [[net.liftmodules.FoBoBs.lib.BootstrapSH.tooltipScript]]
+    * @see [[net.liftmodules.fobobs4.lib.BootstrapSH.tooltipScript]]
     * @since v2.0
     */
   def tooltip: CssSel = {

Bootstrap/Bootstrap4/TwBs-Bootstrap4-Res/README.md

@@ -0,0 +1,63 @@
+# FoBo TwBs Bootstrap4 Resource Module
+
+This resource module provides Bootstrap 4.x resource components to the FoBo TwBs Bootstrap3 Toolkit Module, 
+but can also be used as-is (see below for setup information).
+
+## Components and available versions 
+
+- Bootstrap [v4.0.0, v4.1.3] - [Bootstrap 4.1](https://getbootstrap.com/docs/4.1)
+
+## Integration into your project 
+
+### Dependency settings
+
+Example setup:
+
+**SBT:**
+```scala
+    "net.liftmodules" %% "fobo-twitter-bootstrap-res_3.3 % "2.1"
+```      
+**Maven:**
+ ```xml         
+<dependency>
+  <groupId>net.liftmodules</groupId>
+  <artifactId>fobo-twitter-bootstrap-res_3.3_2.12.6</artifactId>
+  <version>2.1</version>
+</dependency>
+``` 
+The example will include a module built for lift 3.3.x. 
+If you are using maven observe that the artifact id also needs the Scala version.
+
+### Lift FoBo boot hooks (when used in the FoBo module)
+```scala
+import net.liftmodules.fobo 
+  :
+fobo.Resource.init = fobo.Resource.BootstrapXXX 
+```
+### Lift FoBo boot hooks (when used as stand alone module)
+```scala
+import net.liftmodules.{fobobsres => fobo}
+  :
+fobo.Resource.init = fobo.Resource.BootstrapXXX 
+```
+### Lift FoBo Template hooks
+```html
+<link href='/classpath/fobo/bootstrap.css' rel="stylesheet" type='text/css'>  
+  :
+<link href='[path/to/you/app/specific/css/file/in/the/webapp/dir]' rel="stylesheet" type='text/css'>
+  :
+  :
+<script src="/classpath/fobo/bootstrap.js" type="text/javascript"></script>
+```
+Here the resources starting with /classpath/fobo/ is the ones provided by the FoBo module. 
+The FoBo js and css files will, without any name change, be served debug-able in development and minimized otherwise. 
+
+### More information
+
+For more information on how to use Twitter Bootstrap in the FoBo module see the [FoBo - Lift Front-End Toolkit Module](https://github.com/karma4u101/FoBo).
+For more information on how to use Twitter Bootstrap see [Twitter Bootstrap](http://twitter.github.com/bootstrap/)
+
+## Contributions
+
+Improvements, contributions and suggestions are welcome! Please see the [Contribution Document](https://github.com/karma4u101/FoBo/blob/master/CONTRIBUTING.md). You can also leave a issue report or drop a question/suggestion on [Lift's mailing list](http://groups.google.com/group/liftweb/) 
+