combinedPresence.groovy

/**
 *  Combined Presence v2.2.1
 *
 *  Copyright 2020 Joel Wetzel
 *
 *  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 *  in compliance with the License. You may obtain a copy of the License at:
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed
 *  on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License
 *  for the specific language governing permissions and limitations under the License.
 *
 */


definition(
    name: "Combined Presence",
    namespace: "joelwetzel",
    author: "Joel Wetzel",
    description: "An app for Hubitat to combine the values of presence sensors.",
    category: "Convenience",
	iconUrl: "",
    iconX2Url: "",
    iconX3Url: "")


preferences {
     page name: "mainPage", title: "", install: true, uninstall: true
}


def installed() {
    log.info "Installed with settings: ${settings}"
    initialize()
}


def updated() {
    log.info "Updated with settings: ${settings}"
    unsubscribe()
    initialize()
}


def initialize() {
    log.info "There are ${childApps.size()} child apps installed."
    childApps.each { child ->
    	log.info "Child app: ${child.label}"
    }
}


def installCheck() {         
	state.appInstalled = app.getInstallationState()
	
	if (state.appInstalled != 'COMPLETE') {
		section{paragraph "Please hit 'Done' to install '${app.label}' parent app "}
  	}
  	else {
    	log.info "Parent Installed OK"
  	}
}


def getFormat(type, myText=""){
	if(type == "header-green") return "<div style='color:#ffffff;font-weight: bold;background-color:#81BC00;border: 1px solid;box-shadow: 2px 3px #A9A9A9'>${myText}</div>"
    if(type == "line") return "\n<hr style='background-color:#1A77C9; height: 1px; border: 0;'></hr>"
	if(type == "title") return "<h2 style='color:#1A77C9;font-weight: bold'>${myText}</h2>"
}


def display(){
	section() {
		paragraph getFormat("line")
		paragraph "<div style='color:#1A77C9;text-align:center'>Combined Presence - @joelwetzel<br><a href='https://github.com/joelwetzel/' target='_blank'>Click here for more Hubitat apps/drivers on my GitHub!</a></div>"
	}       
}


def mainPage() {
    dynamicPage(name: "mainPage") {
    	installCheck()
		
		if (state.appInstalled == 'COMPLETE') {
			section(getFormat("title", "${app.label}")) {
				paragraph "Combine two or more presence sensors to control an output Virtual Presence Sensor."
			}
  			section("<b>Standard Combiners:</b>  (Use this for combining wifi and gps-based sensors for a single person.  It is optimized for that.)") {
				app(name: "anyOpenApp", appName: "Combined Presence Standard Combiner", namespace: "joelwetzel", title: "<b>Add a new Standard Combiner</b>", multiple: true)
			}
  			section("<b>Boolean-OR Combiners:</b>  (Example of use:  If Person1 OR Person2 is home, then the virtual SomeoneIsHome sensor should be home.)") {
				app(name: "anyOpenApp", appName: "Combined Presence Boolean Combiner", namespace: "joelwetzel", title: "<b>Add a new Boolean-OR Combiner</b>", multiple: true)
			}
			section("<b>Advanced Combiners:</b>  (All logic options.  It is a superset of what the Standard and Boolean-OR combiners can do, and you can re-create their functionality by configuring it correctly.  But almost no one will need this.)") {
				app(name: "advancedAnyOpenApp", appName: "Combined Presence Advanced Combiner", namespace: "joelwetzel", title: "<b>Add a new Advanced Combiner</b>", multiple: true)
			}
			display()
		}
	}
}