Rising Sign Calculator WordPress Plugin Documentation

Rising Sign Calculator WordPress Plugin

About

Rising Sign Calculator is an astrology WordPress plugin that adds a widget that lets visitors calculate their Ascendant by entering their birth date, birth time, and birth city. You can also add the Rising Sign Calculator to any page or post with a shortcode.

The calculator gives the Ascendant degree, minute, and second, as well as a symbol of the rising sign. You have the option to enter custom interpretations for the twelve rising signs. If you do not enter a custom interpretation, the calculator will simply show the rising sign, rising symbol, and the ascendant degree.

Rising Sign Calculator uses the Swiss Ephemeris to get the longitude of the Ascendant.

Top

Languages

These languages are included in Rising Sign Calculator plugin:

English (default)

Spanish

Rising Sign Calculator plugin is translation-ready, and includes a .pot file to make it easy for you to translate it into other languages.

Requirements and Specs

Your server must have at least PHP 5.x installed. You must be using WordPress WordPress 3.3.1 or higher.

Your web host must allow file permissions be set (chmod 755). The plugin does this automatically, and works fine with most web hosts, but I have been alerted to at least 1 web host that blocks this. Also, your web host must allow the PHP exec() function.

Top

Screenshots

Top

Non-WordPress Option

See the non-WordPress version here: web app version of Rising Sign Calculator.

Getting Started

Installation

  1. Log in to your WordPress dashboard.
  2. Go to “Plugins -> Add New“.
  3. Click “Upload”
  4. Click “Browse” and locate the .zip file which you purchased from me.
  5. Click “Install Now”.
  6. Activate the plugin by clicking “Activate“.
  7. The Rising Sign Calculator widget will be available in “Appearance -> Widgets“.
  8. To use the widget, drag the widget to a sidebar widget area like you would any other widget.
  9. To use the Rising Sign Calculator on a page or post instead of a widget, paste this shortcode into the page or post:

    [risingcalc]

  10. To write your own custom interpretation for each rising sign, go to “Settings -> Rising Sign Calculator” from your WordPress admin dashboard.

Top

Activate Your Plugin License For Upgrades and Support

Plugin updates will be delivered to your WordPress dashboard if you have an active license. To activate your plugin license, follow these steps:

  1. You have received a license key in your purchase receipt; copy the key to your clipboard.
  2. In your WordPress dashboard, go to “Plugins -> Rising Sign Calculator License“.
  3. Paste your key into the “License Key” field.
  4. Click “Save Changes”.
  5. Click “activate” to activate your license. If the license is properly activated, you will see “Status: active” in green.
  6. Now, anytime a new version of the plugin is available, you will be notified of the update just like with free plugins in the WordPress repository.

Top

Customizing

Stop Scripts and Stylesheet From Loading on All Pages

By default, the Rising Sign Calculator scripts and stylesheet will be loaded on all pages. This is because if the calculator is used as a widget, it can show up on all pages.

However, if you will use the calculator only on one page (for example, by using the shortcode), then you can stop the scripts from loading on all pages. You will want to load the scripts only on the page or post that has the calculator.

The following code will stop the Rising Sign Calculator scripts and stylesheet from loading on all pages, and make them only load on the one page that you designate. Designate the page by editing line 11 below. Replace 'rising-calculator-page-slug' with your page slug.

function isa_remove_rsc_scripts() {

	// remove rising sign plugin scripts and styles
	wp_dequeue_script( 'rsc-jquery-ui' );
	wp_dequeue_script( 'rsc' );
	wp_dequeue_style( 'rsc-jquery-ui' );
	wp_dequeue_style( 'rsc' );

        // only enqueue scripts on the 1 page

	if( is_page( 'rising-calculator-page-slug' ) ) {
		wp_enqueue_script( 'rsc-jquery-ui' );
		wp_enqueue_script( 'rsc' );
		wp_enqueue_style( 'rsc' );
		wp_enqueue_style( 'rsc-jquery-ui' );
	}
}
add_action('wp_enqueue_scripts','isa_remove_rsc_scripts', 200); 

Top

Troubleshooting

Some cache plugins can cause a conflict. If you are using a cache plugin, make sure that it is not caching your admin pages. Try adding the admin pages to the cache’s “Do Not Cache” list, if it has one.

For example, if you use Hyper Cache plugin, add this to the “URI to reject” in the “Filters” section:

/admin
/admin/

Top

The Calculator Always Says Aries

The plugin includes a file that must have permission to execute (CHMOD 755) in order to get the ascendant’s degree from the Swiss Ephemeris. The file is:

rising-sign-calculator/sweph/isabelse

The plugin sets this permission automatically. If the calculator always returns Aries as the rising sign, it means that your server did not allow the plugin to set file permissions to 755. If you feel comfortable with this, you can check this file’s permission on your server to be sure. You may manually have to set the permission to 755.

If you confirm that the file (rising-sign-calculator/sweph/isabelse) has the proper permissions set to 755, and yet the calculator is still stuck on Aries, then it may be that your server does not allow scripts to execute using the PHP exec() function. In this case, this plugin will not work for you.

If your web host blocks the PHP exec() function, you should consider using a web host that does not block this. Executing scripts is part of what web hosting is.

Top

Updated on March 6, 2017